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