Appearance
qin.setNavigationBarTitle(OBJECT)
动态设置当前页面的标题。
OBJECT 参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | String | 是 | 页面标题 |
| success | Function | 否 | 接口调用成功的回调函数 |
| fail | Function | 否 | 接口调用失败的回调函数 |
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例
js
qin.setNavigationBarTitle({
title: '新的标题'
});qin.setNavigationBarTitle({
title: '新的标题'
});注意
如果需要在页面进入时设置标题,可以在 onReady 内执行,以避免被框架内的修改所覆盖。如果必须在 onShow 内执行需要延迟一小段时间
qin.setNavigationBarColor(OBJECT)
设置页面导航条颜色。如果需要进入页面就设置颜色,请延迟执行,防止被框架内设置颜色逻辑覆盖
平台差异说明
| H5 | 微信小程序 | 小红书小程序 | 抖音小程序 | 快手小程序 |
|---|---|---|---|---|
| √ | √ | √ | √ | √ |
OBJECT 参数说明
| 参数 | 类型 | 必填 | 说明 | 平台差异说明 |
|---|---|---|---|---|
| frontColor | String | 是 | 前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff 和 #000000 | H5 、微信小程序、抖音小程序、快手小程序 |
| backgroundColor | String | 是 | 背景颜色值,有效值为十六进制颜色 | |
| animation | Object | 否 | 动画效果, {duration,timingFunc} | 微信小程序、快手小程序 |
| success | Function | 否 | 接口调用成功的回调函数 | |
| fail | Function | 否 | 接口调用失败的回调函数 | |
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
注意
如果需要在页面进入时设置标题,可以在 onReady 内执行,以避免被框架内的修改所覆盖。如果必须在 onShow 内执行需要延迟一小段时间
animation 结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| duration | number | 0 | 否 | 动画变化时间,单位 ms |
| timingFunc | String | 'linear' | 否 | 动画变化方式 |
animation.timingFunc 有效值
| 值 | 说明 |
|---|---|
| linear | 动画从头到尾的速度是相同的。 |
| easeIn | 动画以低速开始 |
| easeOut | 动画以低速结束。 |
| easeInOut | 动画以低速开始和结束。 |
success返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| errMsg | String | 调用结果 |
示例
js
qin.setNavigationBarColor({
frontColor: '#ffffff',
backgroundColor: '#ff0000',
animation: {
duration: 400,
timingFunc: 'easeIn',
},
});qin.setNavigationBarColor({
frontColor: '#ffffff',
backgroundColor: '#ff0000',
animation: {
duration: 400,
timingFunc: 'easeIn',
},
});qin.showNavigationBarLoading(OBJECT)
在当前页面显示导航条加载动画。
平台差异说明
| H5 | 微信小程序 | 小红书小程序 | 抖音小程序 | 快手小程序 |
|---|---|---|---|---|
| √ | √ | √ | x | √ |
OBJECT 参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | Function | 否 | 接口调用成功的回调函数 |
| fail | Function | 否 | 接口调用失败的回调函数 |
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例
js
qin.showNavigationBarLoading()qin.showNavigationBarLoading()qin.hideNavigationBarLoading(OBJECT)
在当前页面隐藏导航条加载动画。
平台差异说明
| H5 | 微信小程序 | 小红书小程序 | 抖音小程序 | 快手小程序 |
|---|---|---|---|---|
| √ | √ | √ | √ | x |
OBJECT 参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | Function | 否 | 接口调用成功的回调函数 |
| fail | Function | 否 | 接口调用失败的回调函数 |
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例
js
qin.hideNavigationBarLoading()qin.hideNavigationBarLoading()qin.hideHomeButton(OBJECT)
隐藏返回首页按钮。
平台差异说明
| H5 | 微信小程序 | 小红书小程序 | 小红书小程序 | 抖音小程序 | 快手小程序 |
|---|---|---|---|---|---|
| √ | x | x | √ | 1.10.0+ | √ |
OBJECT 参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | Function | 否 | 接口调用成功的回调函数 |
| fail | Function | 否 | 接口调用失败的回调函数 |
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例
js
qin.hideHomeButton()qin.hideHomeButton()说明
- 微信小程序自基础库版本 2.8.3 开始支持
- 当用户打开的小程序最底层页面是非首页时,默认展示“返回首页”按钮,开发者可在页面
onShow中调用hideHomeButton进行隐藏。