kuito.
Get started

SystemBars

component

Set system bar appearance while a view is active. Use it for a dark gallery or a screen that draws behind system UI.

Use light system controls over a dark screen

tsx
import { SystemBars, Text, VStack } from 'kuito';

export default function Gallery() {
  return (
    <>
      <SystemBars
        statusBar={{ content: 'light' }}
        backgroundColor="#101014"
        navigationBarColor="#101014"
        navigationBarButtonStyle="light"
      />
      <VStack flex={1} backgroundColor="#101014">
        <Text color="#ffffff">Photos</Text>
      </VStack>
    </>
  );
}

Behavior

Status bar content style names the foreground color. Use SafeArea for content spacing; SystemBars sets appearance. Android navigation bar settings apply to its system navigation controls.

Continue

Read Window for a complete workflow. See the complete prop reference for types and documented defaults.

Reference

Signatures

ts
(props: SystemBarsProps): KuitoNode

Parameters

NameTypeRequiredDescription
propsSystemBarsPropsYes—

Returns

KuitoNode

Props: SystemBarsProps

Props (including inherited props) 7

NameTypeRequiredDescription
statusBarStatusBarOptionsNoThe status bar's content color, visibility and, on Android, color.
backgroundColorstringNoThe root view's color, seen behind the app's views.
navigationBarColorstringNoAndroid: drawn behind the navigation bar.
navigationBarButtonStyleNavigationBarButtonStyleNoAndroid: light buttons for a dark navigation bar, dark buttons for a light one.
navigationBarHiddenbooleanNoAndroid: hides the navigation bar; a swipe from the edge shows it for a moment.
immersivebooleanNoFull screen: hides the status bar, the navigation bar and the home indicator, and on iOS edge swipes reach the app first. The entry's own props, and later entries, win over what it hides.
homeIndicatorAutoHiddenbooleanNoiOS: lets the home indicator fade out while the user doesn't touch the screen.
statusBar — nested fields

statusBar fields

NameTypeRequiredDescription
contentStatusBarContentNoThe color of the status bar's text and icons.
hiddenbooleanNo—
animatedbooleanNoWhether changes to content, hidden and backgroundColor animate.
transitionStatusBarTransitionNoiOS: how showing and hiding animates, when animated.
backgroundColorstringNoAndroid: drawn behind the status bar; a hex color.
translucentbooleanNoAndroid: false lays the app out below the status bar instead of under it.
Generated from the public TypeScript declarations: signatures, props and defaults come from the checked source, descriptions from its JSDoc. No defaults are invented.