Version: 下个版本

Taro.setNavigationBarColor(option)

设置页面导航条颜色

参考文档

类型#

(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': 动画以低速开始和结束;

示例代码#

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

API 支持度#

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