StatusBar #

Component to control the app status bar.

Usage with Navigator #

It is possible to have multiple StatusBar components mounted at the same time. The props will be merged in the order the StatusBar components were mounted. One use case is to specify status bar styles per route using Navigator.

<View> <StatusBar backgroundColor="blue" barStyle="light-content" /> <Navigator initialRoute={{statusBarHidden: true}} renderScene={(route, navigator) => <View> <StatusBar hidden={route.statusBarHidden} /> ... </View> } /> </View>

Imperative API #

For cases where using a component is not ideal, there is also an imperative API exposed as static functions on the component. It is however not recommended to use the static API and the component for the same prop because any value set by the static API will get overriden by the one set by the component in the next render.

Constants #

currentHeight (Android only) The height of the status bar.

Props #

animated?: bool #

If the transition between status bar property changes should be animated. Supported for backgroundColor, barStyle and hidden.

barStyle?: enum('default', 'light-content', 'dark-content') #

Sets the color of the status bar text.

hidden?: bool #

If the status bar is hidden.

androidbackgroundColor?: color #

The background color of the status bar.

androidtranslucent?: bool #

If the status bar is translucent. When translucent is set to true, the app will draw under the status bar. This is useful when using a semi transparent status bar color.

iosnetworkActivityIndicatorVisible?: bool #

If the network activity indicator should be visible.

iosshowHideTransition?: enum('fade', 'slide') #

The transition effect when showing and hiding the status bar using the hidden prop. Defaults to 'fade'.

Methods #

static setHidden(hidden: boolean, animation?: StatusBarAnimation) #

Show or hide the status bar

Parameters:
Name and TypeDescription
hidden

boolean

Hide the status bar.

[animation]

Optional animation when changing the status bar hidden property.

static setBarStyle(style: StatusBarStyle, animated?: boolean) #

Set the status bar style

Parameters:
Name and TypeDescription
style

Status bar style to set

[animated]

boolean

Animate the style change.

static setNetworkActivityIndicatorVisible(visible: boolean) #

Control the visibility of the network activity indicator

Parameters:
Name and TypeDescription
visible

boolean

Show the indicator.

static setBackgroundColor(color: string, animated?: boolean) #

Set the background color for the status bar

Parameters:
Name and TypeDescription
color

string

Background color.

[animated]

boolean

Animate the style change.

static setTranslucent(translucent: boolean) #

Control the translucency of the status bar

Parameters:
Name and TypeDescription
translucent

boolean

Set as translucent.

Type Definitions #

StatusBarStyle #

Status bar style

Type:
$Enum

Constants:
ValueDescription
default

Default status bar style (dark for iOS, light for Android)

light-content

Dark background, white texts and icons

dark-content

Light background, dark texts and icons

StatusBarAnimation #

Status bar animation

Type:
$Enum

Constants:
ValueDescription
none

No animation

fade

Fade animation

slide

Slide animation

Improve this page by sending a pull request!