Q群 567530369,小伙伴们都在这里等你哦~

StatusBar

控制应用状态栏的组件。

和导航器一起使用的注意事项

由于StatusBar可以在任意视图中加载,且后加载的设置会覆盖先前的设置。因此在配合导航器使用时,请务必考虑清楚StatusBar的放置顺序。

静态API

有些场景并不适合使用组件,因此StatusBar也暴露了一个静态API。然而不推荐大家同时通过静态API和组件来定义相同的属性,因为静态API定义的属性值在后续的渲染中会被组件中定义的值所覆盖。

常量

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

查看Props

查看方法

查看类型定义


文档

Props

animated

指定状态栏的变化是否应以动画形式呈现。目前支持这几种样式:backgroundColor, barStyle和hidden。

类型必填
bool

barStyle

设置状态栏文本的颜色。

类型必填
enum('default', 'light-content', 'dark-content')

hidden

是否隐藏状态栏。

类型必填
bool

backgroundColor

状态栏的背景色。

类型必填平台
colorAndroid

translucent

指定状态栏是否透明。设置为true时,应用会延伸到状态栏之下绘制(即所谓“沉浸式”——被状态栏遮住一部分)。常和带有半透明背景色的状态栏搭配使用。

类型必填平台
boolAndroid

networkActivityIndicatorVisible

指定是否显示网络活动提示符。

类型必填平台
booliOS

showHideTransition

通过hidden属性来显示或隐藏状态栏时所使用的动画效果。默认值为'fade'。

类型必填平台
enum('fade', 'slide')iOS

方法

setHidden()


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

显示/隐藏状态栏

参数:

名称类型必填说明
hiddenboolean是否隐藏状态栏
animationStatusBarAnimation改变状态栏显示状态的动画过渡效果

setBarStyle()


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

设置状态栏的样式

参数:

名称类型必填说明
styleStatusBarStyle要设置的状态栏样式
animatedboolean是否启用过渡动画

setNetworkActivityIndicatorVisible()


static setNetworkActivityIndicatorVisible(visible: boolean)

显示/隐藏网络活动指示器

参数:

名称类型必填说明
visibleboolean是否显示网络活动指示器

setBackgroundColor()


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

设置状态栏的背景色

参数:

名称类型必填说明
colorstring背景色
animatedboolean是否启用过渡动画

setTranslucent()


static setTranslucent(translucent: boolean)

指定状态栏是否透明。设置为true时,应用会在状态栏之下绘制(即所谓“沉浸式”——被状态栏遮住一部分)。常和带有半透明背景色的状态栏搭配使用。

参数:

名称类型必填说明
translucentbooleanSet as translucent.

类型定义

StatusBarStyle

状态栏样式

类型
$Enum

常量:

Value说明
default默认的样式(IOS为白底黑字、Android为黑底白字)
light-content黑底白字
dark-content白底黑字(需要Android API>=23)

StatusBarAnimation

状态栏动画过渡效果

类型
$Enum

常量:

Value说明
none没有动画
fade渐变效果
slide滑动效果