跳到主要内容

StatusBar

用于控制应用状态栏的组件。状态栏是通常位于屏幕顶部的一个区域,显示当前时间、Wi-Fi 和蜂窝网络信息、电池电量以及/或其他状态图标。

与导航器一起使用

可以同时挂载多个 StatusBar 组件。属性将按照 StatusBar 组件挂载的顺序进行合并。

命令式 API

对于使用组件不理想的情况,组件上还暴露了一个作为静态函数的命令式 API。但是,不建议对同一属性同时使用静态 API 和组件,因为静态 API 设置的任何值都会在下一次渲染中被组件设置的值覆盖。


参考

常量

currentHeight
Android

状态栏的高度,如果存在刘海屏,则包括刘海屏的高度。


属性

animated

状态栏属性更改之间的过渡是否应动画化。支持 backgroundColorbarStylehidden 属性。

类型必需默认
booleanfalse

backgroundColor
Android

状态栏的背景颜色。

警告

由于 Android 15 中引入的全面屏强制执行,在 API 级别 35 中设置状态栏背景颜色已被弃用,并且设置它将无效。你可以在此处阅读更多关于我们的全面屏建议

类型必需默认
颜色默认系统状态栏背景颜色,如果未定义则为 'black'

barStyle

设置状态栏文本的颜色。

在 Android 上,这仅对 API 版本 23 及以上有效。

类型必需默认
StatusBarStyle'default'

hidden

状态栏是否隐藏。

类型必需默认
booleanfalse

networkActivityIndicatorVisible
iOS

网络活动指示器是否应可见。

类型默认
booleanfalse

showHideTransition
iOS

使用 hidden 属性显示和隐藏状态栏时的过渡效果。

类型默认
StatusBarAnimation'fade'

translucent
Android

状态栏是否半透明。当 translucent 设置为 true 时,应用将在状态栏下方绘制。这在使用半透明状态栏颜色时很有用。

警告

由于 Android 15 中引入的全面屏强制执行,在 API 级别 35 中将状态栏设置为半透明已被弃用,并且设置它将无效。你可以在此处阅读更多关于我们的全面屏建议

类型默认
booleanfalse

方法

popStackEntry()

tsx
static popStackEntry(entry: StatusBarProps);

从堆栈中获取并移除最后一个 StatusBar 条目。

参数

名称类型描述
entry
必需
anypushStackEntry 返回的条目。

pushStackEntry()

tsx
static pushStackEntry(props: StatusBarProps): StatusBarProps;

将一个 StatusBar 条目推入堆栈。完成时,返回值应传递给 popStackEntry

参数

名称类型描述
props
必需
any包含要在堆栈条目中使用的 StatusBar 属性的对象。

replaceStackEntry()

tsx
static replaceStackEntry(
entry: StatusBarProps,
props: StatusBarProps
): StatusBarProps;

用新属性替换现有的 StatusBar 堆栈条目。

参数

名称类型描述
entry
必需
anypushStackEntry 返回的要替换的条目。
props
必需
any包含要在替换堆栈条目中使用的 StatusBar 属性的对象。

setBackgroundColor()
Android

tsx
static setBackgroundColor(color: ColorValue, animated?: boolean);

设置状态栏的背景颜色。

警告

由于 Android 15 中引入的全面屏强制执行,在 API 级别 35 中设置状态栏背景颜色已被弃用,并且设置它将无效。你可以在此处阅读更多关于我们的全面屏建议

参数

名称类型描述
颜色
必需
string背景颜色。
animatedboolean动画化样式更改。

setBarStyle()

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

设置状态栏样式。

参数

名称类型描述
style
必需
StatusBarStyle要设置的状态栏样式。
animatedboolean动画化样式更改。

setHidden()

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

显示或隐藏状态栏。

参数

名称类型描述
hidden
必需
boolean隐藏状态栏。
animation
iOS
StatusBarAnimation更改状态栏隐藏属性时的动画。

setNetworkActivityIndicatorVisible()
iOS

tsx
static setNetworkActivityIndicatorVisible(visible: boolean);

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

参数

名称类型描述
visible
必需
boolean显示指示器。

setTranslucent()
Android

tsx
static setTranslucent(translucent: boolean);

控制状态栏的半透明性。

警告

由于 Android 15 中引入的全面屏强制执行,在 API 级别 35 中将状态栏设置为半透明已被弃用,并且设置它将无效。你可以在此处阅读更多关于我们的全面屏建议

参数

名称类型描述
translucent
必需
boolean设置为半透明。

类型定义

StatusBarAnimation

iOS 上用于过渡的状态栏动画类型。

类型
枚举

常量

类型描述
'fade'string淡入淡出动画
'slide'string滑动动画
'none'string无动画

StatusBarStyle

状态栏样式类型。

类型
枚举

常量

类型描述
'default'string默认状态栏样式(iOS 为深色,Android 为浅色)
'light-content'string白色文本和图标
'dark-content'string深色文本和图标(Android 上需要 API >=23)