# uni.setNavigationBarColor(options)

设置导航条、状态栏颜色

即便pages.json里没有配置NavigationBar,如需修改状态栏的前景背景,也需要本API。

# # 参数

名称 类型 必填 默认值 描述
options SetNavigationBarColorOptions - -

# # SetNavigationBarColorOptions 属性值

名称 类型 必备 默认值 描述
frontColor #ffffff | #000000 - 前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff 和 #000000
backgroundColor string - 背景颜色值,有效值为十六进制颜色
success (result: AsyncApiSuccessResult) => void - 接口调用成功的回调函数
fail (error: UniError) => void - 接口调用失败的回调函数
complete (res: AsyncApiResult) => void - 接口调用结束的回调函数(调用成功、失败都会执行)
# # AsyncApiSuccessResult 属性值
名称 类型 必备 默认值 描述
errMsg string - -
# # AsyncApiResult 属性值
名称 类型 必备 默认值 描述
errMsg string - -
# # SetNavigationBarColorOptions 兼容性
安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
frontColor 5.0 10.0 x
backgroundColor 5.0 10.0 x
success 5.0 10.0 x
fail 5.0 10.0 x
complete 5.0 10.0 x

# # setNavigationBarColor 兼容性

安卓系统版本 安卓 uni-app 安卓 uni-app-x iOS 系统版本 iOS uni-app iOS uni-app-x
5.0 10.0 x

# # 参见

setNavigationBarColor

# # 通用类型

# # GeneralCallbackResult

名称 类型 必备 默认值 描述
errMsg string - 错误信息