uni.setNavigationBarColor(OBJECT)
是 uni-app 提供的用于设置当前页面导航条颜色的 API。
使用说明
此 API 允许你自定义当前页面的导航栏的背景色和前景色(即标题、按钮等元素的颜色)。
API 结构
参数结构如下:
javascript
uni.setNavigationBarColor({
frontColor: '#ffffff', // 必填,前景色值,包含按钮、标题的颜色
backgroundColor: '#ff0000', // 必填,背景色值
animation: { // 导航栏颜色变化时的动画
duration: 100,
timingFunc: 'easeIn'
}
});
示例代码
以下是一个如何使用 uni.setNavigationBarColor
设置页面的导航栏颜色的示例:
javascript
uni.setNavigationBarColor({
frontColor: '#ffffff', // 前景色,只能是#ffffff或#000000
backgroundColor: '#ff0000', // 导航栏背景颜色
animation: { // 动画效果
duration: 400,
timingFunc: 'easeIn'
},
success: function () {
console.log('导航栏颜色设置成功');
},
fail: function (err) {
console.log('导航栏颜色设置失败', err);
}
});
在此示例中,我们设置导航栏背景为红色,文字和按钮为白色,并定义了一个持续400毫秒的动画效果。
请注意,在一些平台上,比如微信小程序,frontColor
只能是 #ffffff
或 #000000
。
查阅更多详情和平台兼容性,您可以访问 uni-app 官方文档。