基础库 1.9.0 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：不支持
微信 Windows 版：支持
微信 Mac 版：支持
微信 鸿蒙 OS 版：支持
移除 tabBar 某一项右上角的文本
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| index | number | 是 | tabBar 的哪一项，从左边算起 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
基础库 1.9.0 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：不支持
微信 Windows 版：支持
微信 Mac 版：支持
微信 鸿蒙 OS 版：支持
为 tabBar 某一项的右上角添加文本
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| index | number | 是 | tabBar 的哪一项，从左边算起 | |
| text | string | 是 | 显示的文本，超过 4 个字符则显示成 … | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
wx.setTabBarBadge({
index: 0,
text: '1'
})
基础库 1.9.0 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：不支持
微信 Windows 版：支持
微信 鸿蒙 OS 版：支持
动态设置 tabBar 某一项的内容，2.7.0 起图片支持临时文件和网络文件。
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| index | number | 是 | tabBar 的哪一项，从左边算起 | |
| text | string | 否 | tab 上的按钮文字 | |
| iconPath | string | 否 | 图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，当 postion 为 top 时，此参数无效 | |
| selectedIconPath | string | 否 | 选中时的图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px ，当 postion 为 top 时，此参数无效 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
wx.setTabBarItem({
index: 0,
text: 'text',
iconPath: '/path/to/iconPath',
selectedIconPath: '/path/to/selectedIconPath'
})
基础库 1.9.0 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：不支持
微信 Windows 版：支持
微信 鸿蒙 OS 版：支持
动态设置 tabBar 的整体样式
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| color | string | 否 | tab 上的文字默认颜色，HexColor | |
| selectedColor | string | 否 | tab 上的文字选中时的颜色，HexColor | |
| backgroundColor | string | 否 | tab 的背景色，HexColor | |
| borderStyle | string | 否 | tabBar上边框的颜色， 仅支持 black/white | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
wx.setTabBarStyle({
color: '#FF0000',
selectedColor: '#00FF00',
backgroundColor: '#0000FF',
borderStyle: 'white'
})
基础库 1.9.0 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：不支持
微信 Windows 版：支持
微信 Mac 版：支持
微信 鸿蒙 OS 版：支持
显示 tabBar
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| animation | boolean | false | 否 | 是否需要动画效果 |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
基础库 1.9.0 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：不支持
微信 Windows 版：支持
微信 Mac 版：支持
微信 鸿蒙 OS 版：支持
显示 tabBar 某一项的右上角的红点
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| index | number | 是 | tabBar 的哪一项，从左边算起 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
基础库 2.1.0 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：支持，需要微信小程序基础库版本不低于 2.4.0
在微信小程序插件中使用时，只能在当前插件的页面中调用
微信 鸿蒙 OS 版：支持
动态设置窗口的背景色
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| backgroundColor | string | 否 | 窗口的背景色，必须为十六进制颜色值 | |
| backgroundColorTop | string | 否 | 顶部窗口的背景色，必须为十六进制颜色值，仅 iOS 支持 | |
| backgroundColorBottom | string | 否 | 底部窗口的背景色，必须为十六进制颜色值，仅 iOS 支持 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
wx.setBackgroundColor({
backgroundColor: '#ffffff', // 窗口的背景色为白色
})
wx.setBackgroundColor({
backgroundColorTop: '#ffffff', // 顶部窗口的背景色为白色
backgroundColorBottom: '#ffffff', // 底部窗口的背景色为白色
})
基础库 2.1.0 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：支持，需要微信小程序基础库版本不低于 2.4.0
在微信小程序插件中使用时，只能在当前插件的页面中调用
微信 鸿蒙 OS 版：支持
动态设置下拉背景字体、loading 图的样式
| 属性 | 类型 | 默认值 | 必填 | 说明 | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| textStyle | string | 是 | 下拉背景字体、loading 图的样式。 | ||||||||
| |||||||||||
| success | function | 否 | 接口调用成功的回调函数 | ||||||||
| fail | function | 否 | 接口调用失败的回调函数 | ||||||||
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） | ||||||||
wx.setBackgroundTextStyle({
textStyle: 'dark' // 下拉背景字体、loading 图的样式为dark
})
基础库 2.8.3 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：不支持
微信 Windows 版：支持
微信 Mac 版：支持
微信 鸿蒙 OS 版：支持
隐藏返回首页按钮。微信7.0.7版本起，当用户打开的微信小程序最底层页面是非首页时，默认展示“返回首页”按钮，开发者可在页面 onShow 中调用 hideHomeButton 进行隐藏。
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
以 Promise 风格 调用：支持
需要页面权限：当前是插件页面时，宿主微信小程序不能调用该接口，反之亦然
微信小程序插件：支持，需要微信小程序基础库版本不低于 2.1.0
在微信小程序插件中使用时，只能在当前插件的页面中调用
微信 Windows 版：支持
微信 Mac 版：支持
微信 鸿蒙 OS 版：支持
在当前页面隐藏导航条加载动画
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |