Skip to content

qin.setNavigationBarTitle(OBJECT) ​

动态设置当前页面的标题。

OBJECT 参数说明

参数类型必填说明
titleString是页面标题
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数(调用成功、失败都会执行)

示例

js
qin.setNavigationBarTitle({
  title: '新的标题'
});
qin.setNavigationBarTitle({
  title: '新的标题'
});

注意

如果需要在页面进入时设置标题,可以在 onReady 内执行,以避免被框架内的修改所覆盖。如果必须在 onShow 内执行需要延迟一小段时间

qin.setNavigationBarColor(OBJECT) ​

设置页面导航条颜色。如果需要进入页面就设置颜色,请延迟执行,防止被框架内设置颜色逻辑覆盖

平台差异说明

H5微信小程序小红书小程序抖音小程序快手小程序
√√√√√

OBJECT 参数说明

参数类型必填说明平台差异说明
frontColorString是前景颜色值,包括按钮、标题、状态栏的颜色,仅支持 #ffffff 和 #000000H5 、微信小程序、抖音小程序、快手小程序
backgroundColorString是背景颜色值,有效值为十六进制颜色
animationObject否动画效果, {duration,timingFunc}微信小程序、快手小程序
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数(调用成功、失败都会执行)

注意

如果需要在页面进入时设置标题,可以在 onReady 内执行,以避免被框架内的修改所覆盖。如果必须在 onShow 内执行需要延迟一小段时间

animation 结构

属性类型默认值必填说明
durationnumber0否动画变化时间,单位 ms
timingFuncString'linear'否动画变化方式

animation.timingFunc 有效值

值说明
linear动画从头到尾的速度是相同的。
easeIn动画以低速开始
easeOut动画以低速结束。
easeInOut动画以低速开始和结束。

success返回参数说明

参数名类型说明
errMsgString调用结果

示例

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 参数说明

参数类型必填说明
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数(调用成功、失败都会执行)

示例

js
qin.showNavigationBarLoading()
qin.showNavigationBarLoading()

qin.hideNavigationBarLoading(OBJECT) ​

在当前页面隐藏导航条加载动画。

平台差异说明

H5微信小程序小红书小程序抖音小程序快手小程序
√√√√x

OBJECT 参数说明

参数类型必填说明
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数(调用成功、失败都会执行)

示例

js
qin.hideNavigationBarLoading()
qin.hideNavigationBarLoading()

qin.hideHomeButton(OBJECT) ​

隐藏返回首页按钮。

平台差异说明

H5微信小程序小红书小程序小红书小程序抖音小程序快手小程序
√xx√1.10.0+√

OBJECT 参数说明

参数类型必填说明
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数(调用成功、失败都会执行)

示例

js
qin.hideHomeButton()
qin.hideHomeButton()

说明

  • 微信小程序自基础库版本 2.8.3 开始支持
  • 当用户打开的小程序最底层页面是非首页时,默认展示“返回首页”按钮,开发者可在页面 onShow 中调用 hideHomeButton 进行隐藏。