Skip to content

Tabs 标签页

使用

分隔内容上有关联但属于不同类别的数据集合。

基础用法

基础的、简洁的标签页。

Tabs 组件提供了选项卡功能, 默认选中第一个标签页,你也可以通过 value 属性来指定当前选中的标签页。

卡片风格的标签

你可以设置具有卡片风格的标签。

只需要设置 type 属性为 card 就可以使选项卡改变为标签风格。

带有边框的卡片风格

你还可以设置标签页为带有边框的卡片

type 设置为 border-card

标签位置的设置

可以通过 tab-position 设置标签的位置

标签一共有四个方向的设置 tabPosition="left|right|top|bottom"

自定义标签页的内容

可以通过具名插槽来实现自定义标签页的内容

动态增减标签页

增减标签页按钮只能在选项卡样式的标签页下使用

增加标签页触发器自定义

标签溢出

API

Tabs Props

参数名描述类型默认值
model-value / v-model绑定值,选中选项卡的 name,默认值是第一个tab的namestring | number-
type风格类型enum''
closable标签是否可关闭booleanfalse
addable是否可新增选项卡booleanfalse
editable标签是否同时可增加和关闭booleanfalse
tab-position选项卡所在位置enumtop
stretch标签宽度是否自撑开booleanfalse
maxWidthtab-position为left或right时有效,设置选项卡的最大宽度string | number-
before-leave切换标签之前的钩子函数,若返回false或者返回被reject的Promise,则阻止切换。Function() => true
show-hide-list 是否显示隐藏的选项卡列表booleantrue

Tabs Events

事件名描述类型
tab-click点击选项卡时触发Function
tab-chargeactiveName改变时触发Function
tab-remove点击tab移除按钮时触发Function
tab-add点击新增选项卡时触发Function
edit点击tab的新增或移除按钮后触发Function
tab-click点击选项卡时触发Function

Tabs Slots

插槽名描述参数
default默认插槽内容-
add-icon自定义添加按钮图标-

TabPane Props

参数名描述类型默认值
label选项卡标题string''
disabled是否禁用选项卡booleanfalse
name与选项卡绑定值 value 对应的标识符,表示选项卡别名string | number-
closable标签是否可关闭booleanfalse
lazy标签是否延迟渲染booleanfalse

TabPane Slots

插槽名描述参数
default选项卡内容-
label选项卡标题-