开发
API

tt.setTabBarBadge

基础库 1.44.0 开始支持,低版本需做 兼容处理

为 tabBar 某一项的右上角添加文本,可以利用此功能进行提示。

语法

tt.setTabBarBadge(options)

参数说明

options 为 object 类型,属性如下:

属性类型必填说明最低支持版本
indexnumbertabBar 的哪一项,从左边算起,左起第一个为 01.44.0
textstring右上角上的文字1.44.0
successfunction接口调用成功的回调函数1.44.0
failfunction接口调用失败的回调函数1.44.0
completefunction接口调用结束的回调函数(调用成功、失败都会执行),回调参数同成功或失败回调1.44.0

回调成功

Object 类型,属性如下:

属性类型说明最低支持版本
errMsgstring"setTabBarBadge:ok"1.44.0

回调失败

Object 类型,属性如下:

属性类型说明最低支持版本
errMsgstring"setTabBarBadge:fail " + 详细错误信息1.44.0

效果示例

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

<button bindtap="setTabBarBadge">
  为第一个 tabBar 右上角添加文本 ByteDance
</button>
Page({
  setTabBarItem() {
    tt.setTabBarBadge({
      index: 0,
      text: "ByteDance",
      success(res) {
        tt.showToast({ title: "设置成功" });
      },
      fail(err) {
        tt.showModal({
          title: "设置失败",
          content: err.errMsg,
          showCancel: false,
        });
      },
      complete(res) {
        console.log("完成设置");
      },
    });
  },
});

Bug & Tip

  • Tip:text 为全部为数字的时, 超过 2 位则显示为 ...
  • Tip:text 不全为数字时, 超过在 4 个字符(2 个中文) 则显示为 ...
  • Tip:抖音 iOS 暂不支持此能力。
点击纠错
评价此篇文档