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.

Referência

Assinaturas

ts
(props: SystemBarsProps): KuitoNode

Parâmetros

NomeTipoObrigatórioDescrição
propsSystemBarsPropsSim—

Devolve

KuitoNode

Props: SystemBarsProps

Props (incluindo props herdadas) 7

NomeTipoObrigatórioDescrição
statusBarStatusBarOptionsNãoThe status bar's content color, visibility and, on Android, color.
backgroundColorstringNãoThe root view's color, seen behind the app's views.
navigationBarColorstringNãoAndroid: drawn behind the navigation bar.
navigationBarButtonStyleNavigationBarButtonStyleNãoAndroid: light buttons for a dark navigation bar, dark buttons for a light one.
navigationBarHiddenbooleanNãoAndroid: hides the navigation bar; a swipe from the edge shows it for a moment.
immersivebooleanNãoFull 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.
homeIndicatorAutoHiddenbooleanNãoiOS: lets the home indicator fade out while the user doesn't touch the screen.
statusBar — campos aninhados

statusBar campos

NomeTipoObrigatórioDescrição
contentStatusBarContentNãoThe color of the status bar's text and icons.
hiddenbooleanNão—
animatedbooleanNãoWhether changes to content, hidden and backgroundColor animate.
transitionStatusBarTransitionNãoiOS: how showing and hiding animates, when animated.
backgroundColorstringNãoAndroid: drawn behind the status bar; a hex color.
translucentbooleanNãoAndroid: false lays the app out below the status bar instead of under it.
Gerado a partir das declarações TypeScript públicas: assinaturas, props e predefinições vêm da fonte verificada, as descrições da sua JSDoc. Nenhuma predefinição é inventada.