Skip to content

标签页组件

标签页组件

标签页组件允许用户在不同视图之间切换,是内容组织和导航的重要方式,通常用于内容分类展示。

基础用法

基础的标签页用法,展示默认的线条样式标签页。

首页内容
显示代码箭头
复制GitHub

不同类型

标签页组件提供了三种不同的类型:线条样式(line)、块状样式(block)和边框样式(border)。

线条样式:
块状样式:
边框样式:
显示代码箭头
复制GitHub

自定义间距

通过设置 gap 属性可以自定义标签页之间的间距,设置为 0 时标签页将充满整个容器。

默认间距 (gap=8):
大间距 (gap=20):
充满容器 (gap=0):
显示代码箭头
复制GitHub

自定义高度

通过设置 height 属性可以自定义标签页的高度。

默认高度 (height=42px):
小尺寸 (height=32px):
大尺寸 (height=56px):
显示代码箭头
复制GitHub

带图标的标签页

通过在 TTabs 组件上使用 icon 属性可以为标签页添加图标。

首页内容
显示代码箭头
复制GitHub

带关闭按钮

设置 is-close 属性为 true 可以启用标签页的关闭功能。

当前标签页: tab1
显示代码箭头
复制GitHub

禁用状态

TTabs 组件上设置 disabled 属性可以禁用特定的标签页。

当前选中: tab1
选项二和选项四被禁用,无法选中
显示代码箭头
复制GitHub

标签页 API

TTabs 属性

属性名说明类型可选值默认值
disabled是否禁用booleanfalse
value标签页的值string/number
icon标签页的图标string

TTabsGroup 属性

属性名说明类型可选值默认值
v-model绑定值string/number
type标签页类型stringline/block/borderline
height标签页高度string42px
gap标签页间距number8
is-close是否显示关闭按钮booleanfalse
action-duration切换动画时长(毫秒)number220

TTabsGroup 事件

事件名说明回调参数
change标签页切换时触发(value: ValueType)
close关闭标签页时触发(value: ValueType)

TTabsGroup 方法

方法名说明参数
updateAction更新action位置

TTabs 插槽

插槽名说明
default标签页的内容

TTabsGroup 插槽

插槽名说明
default放置 TTabs 组件

样式变量

标签页组件使用了以下样式变量,可通过 SCSS 变量进行自定义:

变量名说明
$theme-color-primary主题色-主要
$theme-color-danger主题色-危险
$text-color-default文本颜色-默认
$font-size-default字体大小-默认

基于MIT许可发布