uni-app x

展示全部

# uni.showTabBar(options?)

显示 tabBar

# showTabBar 兼容性 ^?

Web	微信小程序	支付宝小程序	Android(VDOM)	Android(Vapor)	iOS(VDOM)	iOS(Vapor)	HarmonyOS
4.0	4.41	5.31	3.91	5.22	4.11	5.14	4.61

# 参数

名称

类型

必填

options

ShowTabBarOptions

否

名称	类型	必备	描述
animation	boolean	否	是否需要动画效果
success	(result: ShowTabBarSuccess) => void	否	接口调用成功的回调函数
fail	(result: ShowTabBarFail) => void	否	接口调用失败的回调函数
complete	(result: ShowTabBarComplete) => void	否	接口调用结束的回调函数（调用成功、失败都会执行）

# ShowTabBarSuccess 的属性值

名称	类型	必备
errMsg	string	是

# ShowTabBarFail 的属性值

名称

类型

必备

描述

errCode

number

是

错误码

合法值	描述
100	TabBar 不存在
200	参数错误

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# ShowTabBarComplete 的属性值

名称	类型	必备
errMsg	string	是

# 返回值

类型

必备

Promise<ShowTabBarSuccess>

否

名称	类型	必备
errMsg	string	是

# 参见

# uni.hideTabBar(options?)

隐藏 tabBar

# hideTabBar 兼容性 ^?

Web	微信小程序	支付宝小程序	Android(VDOM)	Android(Vapor)	iOS(VDOM)	iOS(Vapor)	HarmonyOS
4.0	4.41	5.31	3.91	5.22	4.11	5.14	4.61

# 参数

名称

类型

必填

options

HideTabBarOptions

否

名称	类型	必备	描述
animation	boolean	否	是否需要动画效果
success	(result: HideTabBarSuccess) => void	否	接口调用成功的回调函数
fail	(result: HideTabBarFail) => void	否	接口调用失败的回调函数
complete	(result: HideTabBarComplete) => void	否	接口调用结束的回调函数（调用成功、失败都会执行）

# HideTabBarSuccess 的属性值

名称	类型	必备
errMsg	string	是

# HideTabBarFail 的属性值

名称

类型

必备

描述

errCode

number

是

错误码

合法值	描述
100	TabBar 不存在
200	参数错误

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# HideTabBarComplete 的属性值

名称	类型	必备
errMsg	string	是

# 返回值

类型

必备

Promise<HideTabBarSuccess>

否

名称	类型	必备
errMsg	string	是

# 参见

# uni.showTabBarRedDot(options)

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

# showTabBarRedDot 兼容性 ^?

Web	微信小程序	支付宝小程序	Android(VDOM)	Android(Vapor)	iOS(VDOM)	iOS(Vapor)	HarmonyOS
4.0	4.41	5.31	3.91	5.22	4.11	5.14	4.61

# 参数

名称

类型

必填

options

ShowTabBarRedDotOptions

是

名称	类型	必备	描述
index	number	是	tabBar的哪一项，从左边算起，索引从0开始
success	(result: ShowTabBarRedDotSuccess) => void	否	接口调用成功的回调函数
fail	(result: ShowTabBarRedDotFail) => void	否	接口调用失败的回调函数
complete	(result: ShowTabBarRedDotComplete) => void	否	接口调用结束的回调函数（调用成功、失败都会执行）

# ShowTabBarRedDotSuccess 的属性值

名称	类型	必备
errMsg	string	是

# ShowTabBarRedDotFail 的属性值

名称

类型

必备

描述

errCode

number

是

错误码

合法值	描述
100	TabBar 不存在
200	参数错误

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# ShowTabBarRedDotComplete 的属性值

名称	类型	必备
errMsg	string	是

# 返回值

类型

必备

Promise<ShowTabBarRedDotSuccess>

否

名称	类型	必备
errMsg	string	是

# 参见

# uni.hideTabBarRedDot(options)

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

# hideTabBarRedDot 兼容性 ^?

Web	微信小程序	支付宝小程序	Android(VDOM)	Android(Vapor)	iOS(VDOM)	iOS(Vapor)	HarmonyOS
4.0	4.41	5.31	3.91	5.22	4.11	5.14	4.61

# 参数

名称

类型

必填

options

HideTabBarRedDotOptions

是

名称	类型	必备	描述
index	number	是	tabBar的哪一项，从左边算起，索引从0开始
success	(result: HideTabBarRedDotSuccess) => void	否	接口调用成功的回调函数
fail	(result: HideTabBarRedDotFail) => void	否	接口调用失败的回调函数
complete	(result: HideTabBarRedDotComplete) => void	否	接口调用结束的回调函数（调用成功、失败都会执行）

# HideTabBarRedDotSuccess 的属性值

名称	类型	必备
errMsg	string	是

# HideTabBarRedDotFail 的属性值

名称

类型

必备

描述

errCode

number

是

错误码

合法值	描述
100	TabBar 不存在
200	参数错误

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# HideTabBarRedDotComplete 的属性值

名称	类型	必备
errMsg	string	是

# 返回值

类型

必备

Promise<HideTabBarRedDotSuccess>

否

名称	类型	必备
errMsg	string	是

# 参见

# uni.setTabBarBadge(options)

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

# setTabBarBadge 兼容性 ^?

Web	微信小程序	支付宝小程序	Android(VDOM)	Android(Vapor)	iOS(VDOM)	iOS(Vapor)	HarmonyOS
4.0	4.41	5.31	3.91	5.22	4.11	5.14	4.61

# 参数

名称

类型

必填

options

SetTabBarBadgeOptions

是

名称	类型	必备	描述
index	number	是	tabBar的哪一项，从左边算起，索引从0开始
text	string	是	显示的文本，不超过 3 个半角字符
success	(result: SetTabBarBadgeSuccess) => void	否	接口调用成功的回调函数
fail	(result: SetTabBarBadgeFail) => void	否	接口调用失败的回调函数
complete	(result: SetTabBarBadgeComplete) => void	否	接口调用结束的回调函数（调用成功、失败都会执行）

# SetTabBarBadgeSuccess 的属性值

名称	类型	必备
errMsg	string	是

# SetTabBarBadgeFail 的属性值

名称

类型

必备

描述

errCode

number

是

错误码

合法值	描述
100	TabBar 不存在
200	参数错误

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# SetTabBarBadgeComplete 的属性值

名称	类型	必备
errMsg	string	是

# 返回值

类型

必备

Promise<SetTabBarBadgeSuccess>

否

名称	类型	必备
errMsg	string	是

# 参见

# uni.removeTabBarBadge(options)

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

# removeTabBarBadge 兼容性 ^?

Web	微信小程序	支付宝小程序	Android(VDOM)	Android(Vapor)	iOS(VDOM)	iOS(Vapor)	HarmonyOS
4.0	4.41	5.31	3.91	5.22	4.11	5.14	4.61

# 参数

名称

类型

必填

options

RemoveTabBarBadgeOptions

是

名称	类型	必备	描述
index	number	是	tabBar的哪一项，从左边算起，索引从0开始
success	(result: RemoveTabBarBadgeSuccess) => void	否	接口调用成功的回调函数
fail	(result: RemoveTabBarBadgeFail) => void	否	接口调用失败的回调函数
complete	(result: RemoveTabBarBadgeComplete) => void	否	接口调用结束的回调函数（调用成功、失败都会执行）

# RemoveTabBarBadgeSuccess 的属性值

名称	类型	必备
errMsg	string	是

# RemoveTabBarBadgeFail 的属性值

名称

类型

必备

描述

errCode

number

是

错误码

合法值	描述
100	TabBar 不存在
200	参数错误

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# RemoveTabBarBadgeComplete 的属性值

名称	类型	必备
errMsg	string	是

# 返回值

类型

必备

Promise<RemoveTabBarBadgeSuccess>

否

名称	类型	必备
errMsg	string	是

# 参见

# uni.setTabBarStyle(options)

动态设置 tabBar 的整体样式

# setTabBarStyle 兼容性 ^?

Web	微信小程序	支付宝小程序	Android(VDOM)	Android(Vapor)	iOS(VDOM)	iOS(Vapor)	HarmonyOS(VDOM)	HarmonyOS(Vapor)
4.0	4.41	5.31	3.91	5.22	4.11	5.14	x	5.0

# 参数

名称

类型

必填

options

SetTabBarStyleOptions

是

名称

类型

必备

兼容性

描述

color

string (string.ColorString)

否

tab 上的文字默认颜色

selectedColor

string (string.ColorString)

否

tab 上的文字选中时的颜色

backgroundColor

string (string.ColorString)

否

tab 的背景色

backgroundImage

string

否

图片背景

backgroundRepeat

string

否

背景图平铺方式

合法值	描述
repeat	背景图片在垂直方向和水平方向平铺
repeat-x	背景图片在水平方向平铺，垂直方向拉伸
repeat-y	背景图片在垂直方向平铺，水平方向拉伸
no-repeat	背景图片在垂直方向和水平方向都拉伸

borderColor

string (string.ColorString)

否

tabbar上边框的颜色（优先级高于 borderStyle）

borderStyle

string

否

tabbar上边框的颜色

合法值
black
white

success

(result: SetTabBarStyleSuccess) => void

否

接口调用成功的回调函数

fail

(result: SetTabBarStyleFail) => void

否

接口调用失败的回调函数

complete

(result: SetTabBarStyleComplete) => void

否

接口调用结束的回调函数（调用成功、失败都会执行）

# SetTabBarStyleSuccess 的属性值

名称	类型	必备
errMsg	string	是

# SetTabBarStyleFail 的属性值

名称

类型

必备

描述

errCode

number

是

错误码

合法值	描述
100	TabBar 不存在
200	参数错误

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# SetTabBarStyleComplete 的属性值

名称	类型	必备
errMsg	string	是

# 返回值

类型

必备

Promise<SetTabBarStyleSuccess>

否

名称	类型	必备
errMsg	string	是

# 参见

# uni.setTabBarItem(options)

动态设置 tabBar 某一项的内容

# setTabBarItem 兼容性 ^?

Web	微信小程序	支付宝小程序	Android(VDOM)	Android(Vapor)	iOS(VDOM)	iOS(Vapor)	HarmonyOS
4.0	4.41	5.31	3.91	5.22	4.11	5.14	4.61

# 参数

名称

类型

必填

options

SetTabBarItemOptions

是

名称

类型

必备

兼容性

描述

index

number

是

tabBar 的哪一项，从左边算起，索引从0开始

text

string

否

tab 上按钮文字

iconPath

string

否

图片路径

selectedIconPath

string

否

选中时的图片路径

pagePath

string

否

页面绝对路径

iconfont

SetTabBarItemIconFontOptions

否

字体图标，优先级高于 iconPath

名称	类型	必备	描述
text	string	是	字库 Unicode 码
selectedText	string	是	选中后字库 Unicode 码
fontSize	string	否	字体图标字号(px)
color	string	否	字体图标颜色
selectedColor	string	否	字体图标选中颜色

visible

boolean

否

tab 是否显示

success

(result: SetTabBarItemSuccess) => void

否

接口调用成功的回调函数

fail

(result: SetTabBarItemFail) => void

否

接口调用失败的回调函数

complete

(result: SetTabBarItemComplete) => void

否

接口调用结束的回调函数（调用成功、失败都会执行）

# SetTabBarItemSuccess 的属性值

名称	类型	必备
errMsg	string	是

# SetTabBarItemFail 的属性值

名称

类型

必备

描述

errCode

number

是

错误码

合法值	描述
100	TabBar 不存在
200	参数错误

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# SetTabBarItemComplete 的属性值

名称	类型	必备
errMsg	string	是

# 返回值

类型

必备

Promise<SetTabBarItemSuccess>

否

名称	类型	必备
errMsg	string	是

# 参见

注意：小程序上无法通过本API动态添加和删除tabbar的item。

# 通用类型

# GeneralCallbackResult

名称	类型	必备	描述
errMsg	string	是	错误信息

# Bug & Tips

自 4.23 起，在非 tabbar 页面调用以上 API 会报错：hideTabBar:fail not TabBar page
uni-app-x harmony 暂不支持隐藏TabBarItem

运营产品

uni-ad uni统计 uni发行 uni安全专题

开发者服务

问答社区开发者后台

技术文档

uni-app文档 uniCloud文档原生开发者支持文档 HBuilder文档

生态服务

插件市场 OAuth用户开放平台

关于我们： DCloud官网案例需求墙许可协议加入我们赞助我们

联系我们：商务合作：bd@dcloud.io 广告合作：uniad@dcloud.io

DCloud.io 数字天堂（北京）网络技术有限公司是

HTML5中国产业联盟发起单位

京公网安备：11010802035340号

国家信息安全等级保护三级，证书编号：11010813802-20001

# uni.showTabBar(options?)

# showTabBar 兼容性 ?

# 参数

# ShowTabBarSuccess 的属性值

# ShowTabBarFail 的属性值

# ShowTabBarComplete 的属性值

# 返回值

# 参见

# uni.hideTabBar(options?)

# hideTabBar 兼容性 ?

# 参数

# HideTabBarSuccess 的属性值

# HideTabBarFail 的属性值

# HideTabBarComplete 的属性值

# 返回值

# 参见

# uni.showTabBarRedDot(options)

# showTabBarRedDot 兼容性 ?

# 参数

# ShowTabBarRedDotSuccess 的属性值

# ShowTabBarRedDotFail 的属性值

# ShowTabBarRedDotComplete 的属性值

# 返回值

# 参见

# uni.hideTabBarRedDot(options)

# hideTabBarRedDot 兼容性 ?

# 参数

# HideTabBarRedDotSuccess 的属性值

# HideTabBarRedDotFail 的属性值

# HideTabBarRedDotComplete 的属性值

# 返回值

# 参见

# uni.setTabBarBadge(options)

# setTabBarBadge 兼容性 ?

# 参数

# SetTabBarBadgeSuccess 的属性值

# SetTabBarBadgeFail 的属性值

# SetTabBarBadgeComplete 的属性值

# 返回值

# 参见

# uni.removeTabBarBadge(options)

# removeTabBarBadge 兼容性 ?

# 参数

# RemoveTabBarBadgeSuccess 的属性值

# RemoveTabBarBadgeFail 的属性值

# RemoveTabBarBadgeComplete 的属性值

# 返回值

# 参见

# uni.setTabBarStyle(options)

# setTabBarStyle 兼容性 ?

# 参数

# SetTabBarStyleSuccess 的属性值

# SetTabBarStyleFail 的属性值

# SetTabBarStyleComplete 的属性值

# 返回值

# 参见

# uni.setTabBarItem(options)

# setTabBarItem 兼容性 ?

# 参数

# SetTabBarItemSuccess 的属性值

# SetTabBarItemFail 的属性值

# SetTabBarItemComplete 的属性值

# 返回值

# 参见

# 通用类型

# GeneralCallbackResult

# Bug & Tips

本页导读

# showTabBar 兼容性 ^?

# hideTabBar 兼容性 ^?

# showTabBarRedDot 兼容性 ^?

# hideTabBarRedDot 兼容性 ^?

# setTabBarBadge 兼容性 ^?

# removeTabBarBadge 兼容性 ^?

# setTabBarStyle 兼容性 ^?

# setTabBarItem 兼容性 ^?