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.

Référence

Signatures

ts
(props: SystemBarsProps): KuitoNode

Paramètres

NomTypeRequisDescription
propsSystemBarsPropsOui—

Retourne

KuitoNode

Props: SystemBarsProps

Props (props héritées incluses) 7

NomTypeRequisDescription
statusBarStatusBarOptionsNonThe status bar's content color, visibility and, on Android, color.
backgroundColorstringNonThe root view's color, seen behind the app's views.
navigationBarColorstringNonAndroid: drawn behind the navigation bar.
navigationBarButtonStyleNavigationBarButtonStyleNonAndroid: light buttons for a dark navigation bar, dark buttons for a light one.
navigationBarHiddenbooleanNonAndroid: hides the navigation bar; a swipe from the edge shows it for a moment.
immersivebooleanNonFull 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.
homeIndicatorAutoHiddenbooleanNoniOS: lets the home indicator fade out while the user doesn't touch the screen.
statusBar — champs imbriqués

statusBar champs

NomTypeRequisDescription
contentStatusBarContentNonThe color of the status bar's text and icons.
hiddenbooleanNon—
animatedbooleanNonWhether changes to content, hidden and backgroundColor animate.
transitionStatusBarTransitionNoniOS: how showing and hiding animates, when animated.
backgroundColorstringNonAndroid: drawn behind the status bar; a hex color.
translucentbooleanNonAndroid: false lays the app out below the status bar instead of under it.
Généré depuis les déclarations TypeScript publiques : signatures, props et valeurs par défaut viennent de la source vérifiée, les descriptions de sa JSDoc. Aucune valeur par défaut n'est inventée.