开发
API

tt.removeTabBarBadge

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

移除 tabBar 某一项右上角的文本。相关 API:tt.setTabBarBadge

语法

tt.removeTabBarBadge(options)

参数说明

options 为 object 类型,属性如下:

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

回调成功

Object 类型,属性如下:

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

回调失败

Object 类型,属性如下:

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

效果示例

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

<button bindtap="setTabBarBadge">
  为第一个 tabBar 右上角添加文本 ByteDance
</button>

<button bindtap="removeTabBarBadge">移除 tabBar 右上角文本</button>
Page({
  setTabBarBadge() {
    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("完成设置");
      },
    });
  },
  removeTabBarBadge() {
    tt.removeTabBarBadge({
      index: 0,
      success(res) {
        tt.showToast({ title: "移除成功" });
      },
      fail(err) {
        tt.showModal({
          title: "移除失败",
          content: err.errMsg,
          showCancel: false,
        });
      },
      complete(res) {
        console.log("完成移除");
      },
    });
  },
});

Bug & Tip

  • Tip:参数 index 必填,从左边算起,第一个为 0。
  • Tip:抖音 iOS 暂不支持此能力。
点击纠错
评价此篇文档