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	幻灯片动画