title: Taro.setNavigationBarColor(option)

sidebar_label: setNavigationBarColor

设置页面导航条颜色

参考文档

类型

  1. (option: Option) => Promise<CallbackResult>

参数

Option

参数 类型 必填 说明
backgroundColor string 背景颜色值,有效值为十六进制颜色
frontColor string 前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff 和 #000000
animation AnimationOption 动画效果
complete (res: CallbackResult) => void 接口调用结束的回调函数(调用成功、失败都会执行)
fail (res: CallbackResult) => void 接口调用失败的回调函数
success (res: CallbackResult) => void 接口调用成功的回调函数

AnimationOption

动画效果

参数 类型 必填 说明
duration number 动画变化时间,单位 ms
timingFunc "linear" | "easeIn" | "easeOut" | "easeInOut" 动画变化方式

可选值:
- ‘linear’: 动画从头到尾的速度是相同的;
- ‘easeIn’: 动画以低速开始;
- ‘easeOut’: 动画以低速结束;
- ‘easeInOut’: 动画以低速开始和结束;

示例代码

  1. Taro.setNavigationBarColor({
  2. frontColor: '#ffffff',
  3. backgroundColor: '#ff0000',
  4. animation: {
  5. duration: 400,
  6. timingFunc: 'easeIn'
  7. }
  8. })

API 支持度

API 微信小程序 H5 React Native
Taro.setNavigationBarColor ✔️ ✔️ ✔️(不支持 animation 参数)