Skip to content

Tabbar 标签栏 ​

显示底部标签导航,支持图标、角标与安全区适配。

支持平台 ​

以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。

App-vueApp-nvue微信小程序支付宝小程序百度小程序字节小程序QQ小程序H5PC快手小程序钉钉小程序
✓✓✓✓✓✓✓✓✓✓✓

基础用法 ​

vue
<!-- 底部标签 -->
<fui-tabbar :tabBar="navigationItems" :current="currentTab" @click="handleTabClick" />

页面需声明标签数据、当前索引和点击方法;点击事件返回当前项的索引及数据。

标签项可包含 text、iconPath、selectedIconPath 或 iconName、selectedIconName,以及 badge、dot 等字段;图片路径和字体图标可按项目实际资源配置。

属性 ​

属性类型说明官网默认值
tabBarArray标签数据[]
currentNumber / String当前索引0
sizeNumber / String字号,单位 rpx24
fontWeightNumber / String字重400
iconSizeNumber / String字体图标大小56
iconUnitString图标大小单位:px 或 rpxrpx
colorString默认文字和图标颜色#333333
selectedColorString选中文字和图标颜色#465CFF
backgroundString背景色#FFFFFF
isBorderBoolean是否显示顶部边框true
borderColorString边框颜色#EEEEEE
isFixedBoolean是否固定在底部true
badgeColorString角标文字颜色#FFFFFF
badgeBackgroundString角标背景色#FF2B2B
zIndexNumber / String层级,nvue 不支持980
safeAreaBoolean固定时是否适配底部安全区true
fixedHeightBooleaninit 返回高度是否包含固定的底部安全区高度false

事件 ​

事件说明回调参数
init标签栏初始化{ height }
click点击标签包含 index 和当前标签字段的对象

非 nvue 平台边框与角标默认色由主题变量控制;nvue 中元素顺序影响层级。

插槽 ​

插槽说明
—官网未列出该组件的插槽