my.setnavigationbar(object object)
支小宝客户端 支持
安诊儿客户端 支持
主体： 企业支付宝小程序 、 个人支付宝小程序
my.setnavigationbar 设置导航栏标题和样式（前景色、背景色、底部边框颜色、左上角 logo 图片）。
object object
| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
|---|---|---|---|---|---|
| title | string | - | 否 | - | 导航栏标题 |
| image | string | - | 否 | - | 导航栏左上角 logo 图片链接地址 |
| backgroundcolor | string | - | 否 | - | 导航栏背景色，支持十六进制颜色值 |
| borderbottomcolor | string | - | 否 | - | 导航栏底部边框颜色，支持十六进制颜色值 |
| frontcolor | string | - | 否 | 基础库: 2.7.24 |
导航栏前景色，包括状态栏文字、按钮、以及标题的颜色。仅支持 #ffffff 和 #000000 |
| success | function | - | 否 | - | 调用成功的回调函数 |
| fail | function | - | 否 | - | 调用失败的回调函数 |
| complete | function | - | 否 | - | 调用结束的回调函数（调用成功、失败都会执行） |
image 参数说明
- 支持 gif 格式，必须使用 https 图片链接；
- 若设置了 image 参数，则 title 参数不再生效；
- ios 请使用 3 倍分辨率标准的高清图片；
borderbottomcolor 参数说明
若设置了 backgroundcolor，则 borderbottomcolor 不再生效，默认会和 backgroundcolor 颜色一样。
fail 回调的参数为 object，error 属性为错误码，errormessage 属性为错误消息。
| 错误码 | 错误消息 | 凯发app官方网站的解决方案 |
|---|---|---|
| 2 | 颜色值不合法 |
1.检查 frontcolor 和 backgroundcolor 是否符合标准 |
代码示例
扫码体验
代码示例
// 设置导航栏前景色。注：frontcolor 需要和 backgroundcolor 一起设置
my.setnavigationbar({
frontcolor: '#ffffff',
backgroundcolor: '#ff0000',
})
// 设置导航栏标题
my.setnavigationbar({
title: '当前标题'
})
// 重置导航栏颜色为默认配色
my.setnavigationbar({
reset: true
})
-
tip导航栏背景色不支持渐变色，可通过自定义导航栏实现。
-
tip导航栏前景色
frontcolor不能单独设置。要和backgroundcolor一起设置才能生效。 -
bug若 ios 端 title 设置空字符串不生效，可以设置一个空格。此为 10.3.80 版本以前的缺陷，10.3.80 版本已修复。
q：导航栏的返回按钮颜色、文字颜色如何修改？
a：
字体颜色、返回按钮颜色属于导航栏前景色。前景色仅支持 #ffffff 和 #000000。
- 可通过此接口入参 frontcolor 直接修改导航栏前景色（基础库 2.7.24 开始支持）
- 也可通过入参 backgroundcolor 间接影响导航栏前景色。即当 backgroundcolor 为白色时，前景色为黑色；当 backgroundcolor 为其他颜色时，前景色为白色。