Expo Docs

StatusBar

Component to control the app status bar.

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>

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.

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


Reference

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

Sets the color of the status bar text.
TypeRequired
enum('default', 'light-content', 'dark-content')No

If the status bar is hidden.
TypeRequired
boolNo

The background color of the status bar.
TypeRequiredPlatform
colorNoAndroid

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.
TypeRequiredPlatform
boolNoAndroid

If the network activity indicator should be visible.
TypeRequiredPlatform
boolNoiOS

The transition effect when showing and hiding the status bar using the hidden prop. Defaults to 'fade'.
TypeRequiredPlatform
enum('fade', 'slide')NoiOS


static setHidden(hidden: boolean, [animation]: StatusBarAnimation)

Show or hide the status bar
Parameters:
NameTypeRequiredDescription
hiddenbooleanYesHide the status bar.
animationStatusBarAnimationNoOptional animation when changing the status bar hidden property.


static setBarStyle(style: StatusBarStyle, [animated]: boolean)

Set the status bar style
Parameters:
NameTypeRequiredDescription
styleStatusBarStyleYesStatus bar style to set
animatedbooleanNoAnimate the style change.


static setNetworkActivityIndicatorVisible(visible: boolean)

Control the visibility of the network activity indicator
Parameters:
NameTypeRequiredDescription
visiblebooleanYesShow the indicator.


static setBackgroundColor(color: string, [animated]: boolean)

Set the background color for the status bar
Parameters:
NameTypeRequiredDescription
colorstringYesBackground color.
animatedbooleanNoAnimate the style change.


static setTranslucent(translucent: boolean)

Control the translucency of the status bar
Parameters:
NameTypeRequiredDescription
translucentbooleanYesSet as translucent.

Status bar style
Type
$Enum
Constants:
ValueDescription
defaultDefault status bar style (dark for iOS, light for Android)
light-contentDark background, white texts and icons
dark-contentLight background, dark texts and icons (requires API>=23 on Android)

Status bar animation
Type
$Enum
Constants:
ValueDescription
noneNo animation
fadeFade animation
slideSlide animation