title: swan.setTabBarItem header: develop nav: api sidebar: tabbar_swan-setTabBarItem

webUrl: https://qft12m.smartapps.cn/swan-api/tab-bar/tab-bar

解释：动态设置 tabBar 某一项的内容

方法参数

Object object

object参数说明

属性名 类型 必填 默认值 说明
index Number 是 tabBar的哪一项，从左边算起。
text String 否 tab 上按钮文字
iconPath String 否 图片绝对路径，icon 大小限制为 40KB，建议尺寸为 81px * 81px，当 position 为 top 时，此参数无效，不支持网络图片。
selectedIconPath String 否 选中时的图片的绝对路径，icon 大小限制为 40KB，建议尺寸为 81px * 81px ，当position为 top 时，此参数无效。
success Function 否 接口调用成功的回调函数
fail Function 否 接口调用失败的回调函数
complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行）

示例

在开发者工具中预览效果

扫码体验

webUrl: https://qft12m.smartapps.cn/swan-api/tab-bar/tab-bar - 图1 请使用百度APP扫码

代码示例

:::codeTab

  1. Page({
  2.     onTabItemTap(item) {
  3.         console.log(item.index);
  4.         if(item.index == 1){
  5.             setTabBarItem(item.index)
  6.         }
  7.         console.log(item.pagePath);
  8.         console.log(item.text);
  9.     }
  10.     setTabBarItem(index) {
  11.         swan.setTabBarItem({
  12.             index: index,
  13.             text: '替换文本',
  14.             iconPath: '/images/API_normal.png',
  15.             selectedIconPath: '/images/API_selected.png',
  16.             success: function () {
  17.                 console.log('setTabBarItem success');
  18.             },
  19.             fail: function (err) {
  20.                 console.log('setTabBarItem fail', err);
  21.             }
  22.         });
  23.     }
  24. });

:::

错误码

Android

错误码 说明
1001 执行失败

iOS

错误码 说明
202 解析失败，请检查参数是否正确。
1002 超过icon文件最大值