Skip to main content
Version: 2.x

Taro.setTabBarItem(option)

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

参考文档

类型#

(option: Option) => Promise<CallbackResult>

参数#

Option#

参数类型必填说明
indexnumbertabBar 的哪一项,从左边算起
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: CallbackResult) => void接口调用失败的回调函数
iconPathstring图片路径,icon 大小限制为 40kb,建议尺寸为 81px * 81px,当 postion 为 top 时,此参数无效
selectedIconPathstring选中时的图片路径,icon 大小限制为 40kb,建议尺寸为 81px * 81px ,当 postion 为 top 时,此参数无效
success(res: CallbackResult) => void接口调用成功的回调函数
textstringtab 上的按钮文字

示例代码#

Taro.setTabBarItem({
index: 0,
text: 'text',
iconPath: '/path/to/iconPath',
selectedIconPath: '/path/to/selectedIconPath'
})

API 支持度#

API微信小程序H5React Native
Taro.setTabBarItem✔️✔️✔️