Skip to content

t-tabs

Tabs 标签页

组件介绍

t-tabs 用于组织和管理多个页面的切换,支持横向滚动、自定义滑块样式和右侧图标。

平台兼容

HarmonyH5AndroidiOS小程序UTS

基础用法

基础用法参考 demo/tabs/tabs.uvue,通过 t-tabs-item 子组件定义标签项。

vue
<!-- 基础标签导航 -->
<t-tabs v-model="current">
  <t-tabs-item title="标签1" :value="0"></t-tabs-item>
  <t-tabs-item title="标签2" :value="1"></t-tabs-item>
  <t-tabs-item title="标签3" :value="2"></t-tabs-item>
</t-tabs>

<!-- 带右侧图标 -->
<t-tabs v-model="current" rightIcon="arrow-down">
  <t-tabs-item title="全部" :value="0"></t-tabs-item>
  <t-tabs-item title="待处理" :value="1" :badge="true" :badgeAttrs="{text: '5'}"></t-tabs-item>
  <t-tabs-item title="已完成" :value="2"></t-tabs-item>
</t-tabs>

<!-- 可滚动标签 -->
<t-tabs v-model="current" :scrollable="true">
  <t-tabs-item v-for="i in 10" :title="'标签' + i" :value="i - 1"></t-tabs-item>
</t-tabs>

Props

属性名说明类型默认值
path点击组件后跳转的页面路径;为空时仅响应事件string''
hover是否启用点击效果booleanfalse
type组件主题类型,可选 infoprimaryerrorwarningsuccessstring''
disabled是否禁用booleanfalse
effect组件显示主题,可选 normaldarklightplainstring'normal'
size组件尺寸,可选 largemediumsmallministring'medium'
barClass滑块的样式,对应外部类 bar-classstring''
current当前滑块所在的索引number1
scrollable是否可滚动booleanfalse
rightIcon右侧图标名称string''
rightIconClass右侧图标的样式,对应外部类 right-icon-classstring''

Events

事件名说明回调参数
change当标签切换时触发value: number
click点击时触发-
transitionend动画结束时触发-
initFinished组件初始化完成时触发,返回组件节点信息-
touchstart触摸开始时触发-
touchend触摸结束时触发-
touchmove触摸移动时触发-
touchcancel触摸取消时触发-

外部类

类名说明
bar-class滑块样式
right-icon-class右侧图标样式

Slots

插槽名说明
default默认插槽,放置 t-tabs-item 子组件
right右侧内容插槽,默认显示右侧图标
bar滑块内容插槽,可自定义滑块样式