Skip to main content
Version: 2.x

Taro.setNavigationBarColor(option)

设置页面导航条颜色

参考文档

类型

(option: Option) => Promise<CallbackResult>

参数

Option

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

AnimationOption

动画效果

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

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

示例代码

Taro.setNavigationBarColor({
frontColor: '#ffffff',
backgroundColor: '#ff0000',
animation: {
duration: 400,
timingFunc: 'easeIn'
}
})

API 支持度

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