跳到主要内容

TabBar 标签栏 ​

WebH5

移动端底部标签栏。56px 高,图标 22px + 文案,支持角标(数字胶囊/小红点),吸底时自动叠加底部安全区。

何时使用 ​

移动端一级导航,3-5 个平级页面的底部切换。

何时不使用 ​

页面内局部 tab 切换(用 Tabs);层级返回导航用 NavBar。

Props ​

名称类型默认值说明
modelValuestring"\"\""激活项 name(v-model)
itemsTabBarItem[]"[]"标签项:{ name, label, icon?, badge? };icon 内置 home/menu/star/user,未知名称显示圆点占位;badge 为 'dot' 显示小红点,其余显示数字胶囊
fixedbooleanfalse吸底固定,padding-bottom 自动叠加 --rn-safe-area-bottom
ariaLabelstring""导航区的 aria-label;为空时取 locale 文案 tabbar.label(默认「主导航」)

Events ​

名称载荷说明
update:modelValuestring点击标签项时触发,payload 为该项 name
changestring激活项变化时触发(点击当前项不触发)

示例 ​

电商主导航 ​

示例加载中…

无角标 ​

示例加载中…

切换回显 + change 事件 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 TabBar 文档(含手机预览)。