tt.setNavigationBarColor
收藏
我的收藏

基础库 1.4.0 开始支持本方法,这是一个异步方法。

设置导航栏颜色。

前提条件
业务背景
使用限制
注意事项
  • Tip:如果当前页面不存在导航栏,会调用 success 和 complete,不会调用 fail;
  • Tip:颜色必须传入完整 6 位 16 进制颜色表达, 避免使用三位缩写, 例如 #fff。
支持沙盒
相关教程

语法

tt.setNavigationBarColor(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
durationnumber0
动画变化时间,单位 ms
2.32.0
timingFuncenumlinear
动画变化方式
2.32.0
frontColorstring
前景颜色值,包括按钮、标题、状态栏的颜色,只能取 `#ffffff` 和 `#000000`
1.4.0
backgroundColorstring
背景颜色值,有效值为十六进制颜色
1.4.0
successfunction
接口调用成功的回调函数
1.4.0
failfunction
接口调用失败的回调函数
1.4.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
1.4.0

timingFunc 的合法值

说明最低支持版本
linear
动画从头到尾的速度是相同的
2.32.0
easeIn
动画以低速开始
2.32.0
easeOut
动画以低速结束
2.32.0
easeInOut
动画以低速开始和结束
2.32.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"setNavigationBarColor:ok"
1.4.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"setNavigationBarColor:fail " + 详细错误信息
1.4.0

扫码体验

请使用字节宿主APP扫码

代码示例