在线文档教程

StatusBar

StatusBar

组件来控制应用程序状态栏。

与导航器一起使用

可以同时安装多个StatusBar组件。道具将按照StatusBar组件的安装顺序进行合并。一个用例是指定每个路由使用的状态栏样式Navigator

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

势在必行的API

对于使用组件的情况并不理想的情况,还有一个必要的API暴露为组件上的静态函数。但是,不建议为同一个道具使用静态API和组件,因为由静态API设置的任何值将被组件在下一个渲染中设置的值覆盖。

常量

currentHeight (仅限Android)状态栏的高度。

Props

animated?: bool

如果状态栏属性更改之间的转换应该是动画。支持backgroundColor,barStyle和隐藏。

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

设置状态栏文本的颜色。

hidden?: bool

如果状态栏被隐藏。

androidbackgroundColor?: color

状态栏的背景颜色。

androidtranslucent?: bool

如果状态栏是半透明的。当半透明设置为true时,应用程序将在状态栏下绘制。这在使用半透明状态栏颜色时非常有用。

iosnetworkActivityIndicatorVisible?: bool

如果网络活动指示符应该可见。

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

使用hidden道具显示和隐藏状态栏时的过渡效果。默认为“淡入淡出”。

方法

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

显示或隐藏状态栏

参数:

名称和类型描述
hiddenboolean隐藏状态栏。
animationStatusBarAnimation更改状态栏隐藏属性时的可选动画。

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

设置状态栏样式

参数:

名称和类型描述
styleStatusBarStyle要设置的状态栏样式
animatedboolean动态改变样式。

static setNetworkActivityIndicatorVisible(visible: boolean)

控制网络活动指示器的可见性

参数:

名称和类型描述
visibleboolean显示指标。

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

设置状态栏的背景颜色

参数:

名称和类型描述
colorstring背景颜色。
animatedboolean动态改变样式。

static setTranslucent(translucent: boolean)

控制状态栏的半透明度

参数:

名称和类型描述
translucentboolean设置为半透明。

类型定义

StatusBarStyle

状态栏样式

类型:

$Enum

常量:

描述
default默认状态栏样式(适用于iOS的黑暗,Android适用的光源)
light-content黑暗的背景,白色文本和图标
dark-content浅色背景,黑暗的文本和图标

StatusBarAnimation

状态栏动画

类型:

$Enum

常量:

描述
none没有动画
fade淡入淡出动画
slide幻灯片动画