uni.setNavigationBarColor(options)

设置导航条、状态栏颜色

注意当pages.json中设置导航栏为custom时：

1. 状态栏的背景色将恒为透明。此时无法通过本API设置状态栏背景色。开发者可自行在状态栏区域放置view，设置背景色。
2. 本API设置前景色frontColor时，会修改状态栏的前景色。

参数

名称	类型	必填	默认值	描述
options	SetNavigationBarColorOptions	是	-	-
名称 类型 必备 默认值 描述 frontColor "#ffffff" | "#000000" 是 - 前景颜色值，包括按钮、标题、状态栏的颜色，仅支持 #ffffff 和 #000000 backgroundColor string.ColorString 是 - 背景颜色值，有效值为十六进制颜色 success (result: AsyncApiSuccessResult) => void 否 - 接口调用成功的回调函数 fail (error: SetNavigationBarColorFail) => void 否 - 接口调用失败的回调函数 complete (res: AsyncApiResult) => void 否 - 接口调用结束的回调函数（调用成功、失败都会执行）

SetNavigationBarColorFail 的属性值

名称	类型	必备	默认值	描述
errCode	number	是	-	-
errSubject	string	是	-	统一错误主题（模块）名称
data	any | null	否	-	错误信息中包含的数据
cause	Error | null	否	-	源错误信息，可以包含多个错误，详见SourceError
errMsg	string	是	-	-

AsyncApiResult 的属性值

名称	类型	必备	默认值	描述
errMsg	string	是	-	-

SetNavigationBarColorOptions 兼容性

	Android	iOS	web
frontColor	√	4.11	4.0
backgroundColor	√	4.11	4.0
success	√	4.11	4.0
fail	√	4.11	4.0
complete	√	4.11	4.0

返回值

类型	必备
Promise | null	否

setNavigationBarColor 兼容性

Android	iOS	web
√	4.11	4.0

参见

• setNavigationBarColor

相关 Bug

示例

hello uni-app x

Template

Script

<template>
  <page-head title="setNavigationBarColor"></page-head>
  <view class="uni-padding-wrap uni-common-mt">
    <button @tap="setNavigationBarColor1" class="uni-btn">
      设置导航条背景绿色，标题白色
    </button>
    <button @tap="setNavigationBarColor2" class="uni-btn">
      设置导航条背景红色，标题黑色
    </button>
    <button @tap="goNavbarLite" class="uni-btn">
      跳转自定义导航栏页面
    </button>
  </view>
</template>

通用类型

GeneralCallbackResult

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