TabBar 标签栏
使用指南
页面底部菜单栏:位于 App 底部,用于在展示多个并列的内容,用于快速在多个页面内容之间进行切换
规则
- Tab标签的数量最少2个,最多支持5个。Tab标签的文字表达应简明清晰,长度应控制在 2-4 个字符。
代码演示
与thinking-ui 2.0版组件的区别以及迁移
按照新的TabBar组件规范修改相关样式
- 弃用的props:
border
API - H3TabBar
Props - H3TabBar
属性 | 说明 | 类型 | 默认值 |
index | 要选中的H3TabBarItem 的下标,若为字符串则为H3TabBarItem 的name 。v-model 绑定值 | string|number | 0 |
activeColor | 选中标签的颜色 | string | #315EFB |
inactiveColor | 未选中标签的颜色 | string | #BBBECA |
fixed | 是否固定在底部 | boolean | true |
Events - H3TabBar
事件名 | 说明 | 参数 |
input | v-model 绑定事件 | value:number|string |
change | 标签选择变化事件 | value:number|string |
API - H3TabBarItem
Props - H3TabBarItem
属性 | 说明 | 类型 | 默认值 |
name | 标签名称,作为匹配的标识符 | string | - |
dot | 是否显示图标右上角小红点 | boolean | false |
text | 图标右上角徽标的内容 | number|string | '' |
limit | 限制text 展示,若超过则为显示 ${limit}+ | number | 99 |
icon | 默认图标名称 | string | '' |
activeIcon | 选中标签图标名称 | string | '' |
Events - H3TabBarItem
Slots - H3TabBarItem
插槽名 | 说明 | SlotProps |
icon | 自定义图标 | {active: 是否为选中标签} |