Skip to main content

StatusBar

The browser has no status bar. Its nearest match is the theme-color meta tag, which mobile browsers paint around the page. StatusBar writes that tag.

import { StatusBar } from 'react-native'

export function DarkScreen() {
return (
<>
<StatusBar backgroundColor="#111827" barStyle="light-content" />
{/* The screen */}
</>
)
}

Props​

PropOn the web
backgroundColorSets the theme-color meta tag.
barStyle, hidden, translucent, animated, showHideTransition, networkActivityIndicatorVisibleAccepted. They have no web effect.

As on native, the last mounted StatusBar wins. When it unmounts, the one before it applies again. When none is left, the tag goes back to its first value.

StatusBar writes the tag in the browser, after mount, so the server HTML doesn't have it. To have the color in the server HTML, set themeColor on Head instead. Use one or the other, because both write the same tag.

Statics​

MemberOn the web
StatusBar.setBackgroundColor(color)Sets the base color, under every mounted StatusBar.
StatusBar.setBarStyle(), setHidden(), setTranslucent(), setNetworkActivityIndicatorVisible()Accepted. No web effect.
StatusBar.pushStackEntry(), popStackEntry(), replaceStackEntry()As on native.
StatusBar.currentHeightnull. The browser has no status bar to make room for.