您的当前位置:首页正文

小程序-界面:TabBar

2024-11-26 来源:个人技术集锦

wx.showTabBarRedDot(Object object)

显示 tabBar 某一项的右上角的红点

参数

Object object

属性类型默认值必填说明
indexnumber tabBar 的哪一项,从左边算起
successfunction 接口调用成功的回调函数
failfunction 接口调用失败的回调函数
completefunction 接口调用结束的回调函数(调用成功、失败都会执行)

wx.showTabBar(Object object)

以  调用:支持

需要页面权限:小程序不能在插件页面中调用该接口,插件也不能在小程序页面中调用该接口

小程序插件:不支持

显示 tabBar

参数

Object object

属性类型默认值必填说明
animationbooleanfalse是否需要动画效果
successfunction 接口调用成功的回调函数
failfunction 接口调用失败的回调函数
completefunction 接口调用结束的回调函数(调用成功、失败都会执行)

wx.setTabBarStyle(Object object)

以  调用:支持

需要页面权限:小程序不能在插件页面中调用该接口,插件也不能在小程序页面中调用该接口

小程序插件:不支持

动态设置 tabBar 的整体样式

参数

Object object

属性类型默认值必填说明
colorstring tab 上的文字默认颜色,HexColor
selectedColorstring tab 上的文字选中时的颜色,HexColor
backgroundColorstring tab 的背景色,HexColor
borderStylestring tabBar上边框的颜色, 仅支持 black/white
successfunction 接口调用成功的回调函数
failfunction 接口调用失败的回调函数
completefunction 接口调用结束的回调函数(调用成功、失败都会执行)

wx.setTabBarItem(Object object)

以  调用:支持

需要页面权限:小程序不能在插件页面中调用该接口,插件也不能在小程序页面中调用该接口

小程序插件:不支持

动态设置 tabBar 某一项的内容,2.7.0 起图片支持临时文件和网络文件。

参数

Object object

属性类型默认值必填说明
indexnumber tabBar 的哪一项,从左边算起
textstring tab 上的按钮文字
iconPathstring 图片路径,icon 大小限制为 40kb,建议尺寸为 81px * 81px,当 postion 为 top 时,此参数无效
selectedIconPathstring 选中时的图片路径,icon 大小限制为 40kb,建议尺寸为 81px * 81px ,当 postion 为 top 时,此参数无效
successfunction 接口调用成功的回调函数
failfunction 接口调用失败的回调函数
completefunction 接口调用结束的回调函数(调用成功、失败都会执行)

wx.setTabBarBadge(Object object)

以  调用:支持

需要页面权限:小程序不能在插件页面中调用该接口,插件也不能在小程序页面中调用该接口

小程序插件:不支持

为 tabBar 某一项的右上角添加文本

参数

Object object

属性类型默认值必填说明
indexnumber tabBar 的哪一项,从左边算起
textstring 显示的文本,超过 4 个字符则显示成 ...
successfunction 接口调用成功的回调函数
failfunction 接口调用失败的回调函数
completefunction 接口调用结束的回调函数(调用成功、失败都会执行)

 

wx.removeTabBarBadge(Object object)

以  调用:支持

需要页面权限:小程序不能在插件页面中调用该接口,插件也不能在小程序页面中调用该接口

小程序插件:不支持

移除 tabBar 某一项右上角的文本

参数

Object object

属性类型默认值必填说明
indexnumber tabBar 的哪一项,从左边算起
successfunction 接口调用成功的回调函数
failfunction 接口调用失败的回调函数
completefunction 接口调用结束的回调函数(调用成功、失败都会执行)

 

wx.hideTabBarRedDot(Object object)

以  调用:支持

需要页面权限:小程序不能在插件页面中调用该接口,插件也不能在小程序页面中调用该接口

小程序插件:不支持

隐藏 tabBar 某一项的右上角的红点

参数

Object object

属性类型默认值必填说明
indexnumber tabBar 的哪一项,从左边算起
successfunction 接口调用成功的回调函数
failfunction 接口调用失败的回调函数
completefunction 接口调用结束的回调函数(调用成功、失败都会执行)

wx.hideTabBar(Object object)

以  调用:支持

需要页面权限:小程序不能在插件页面中调用该接口,插件也不能在小程序页面中调用该接口

小程序插件:不支持

隐藏 tabBar

参数

Object object

属性类型默认值必填说明
animationbooleanfalse是否需要动画效果
successfunction 接口调用成功的回调函数
failfunction 接口调用失败的回调函数
completefunction 接口调用结束的回调函数(调用成功、失败都会执行)

 

显示全文