Tabs 标签页

将属于不同类型但彼此相关的数据集合分区展示。

基础用法

简洁的基础标签页。

标签页提供可选卡片式切换能力。默认选中第一个标签为激活状态,你也可以通过设置 value 属性来激活任意标签。

User

卡片样式

卡片样式的标签页。

type 设置为 card 即可获得卡片样式。

User

边框卡片

带边框的卡片式标签页。

type 设置为 border-card

标签位置

可使用 tab-position 属性设置标签所在位置。

可从四个方向中选择:tabPosition="left|right|top|bottom"

自定义标签

可使用具名插槽自定义标签标题内容。

新增与关闭标签

仅卡片类型标签页支持新增与关闭。

Tab 2 content

自定义新增按钮图标

Tab 2 content

自定义新增标签的触发按钮

Tab 2 content

默认值

default-value: third
active:

标签页 API

标签页 属性

名称说明类型默认值
model-value / v-model绑定值,选中标签的名称;默认值为第一个标签的名称string / number
default-value初次渲染时应激活的标签值(可避免初始过渡动画)string / number
type标签页类型enum''
closable标签是否可关闭booleanfalse
addable标签是否可新增booleanfalse
editable标签是否同时可新增和关闭booleanfalse
tab-position标签栏位置enumtop
stretch标签宽度是否自动撑满容器booleanfalse
before-leave切换标签前的钩子;若返回 false,或返回 Promise 且被拒绝,则阻止切换Function() => true
tabindex标签页的 tabindexstring / number0

标签页 事件

名称说明参数
tab-click点击标签时触发Function
tab-changeactiveName 改变时触发Function
tab-remove点击标签移除按钮时触发Function
tab-add点击标签新增按钮时触发Function
edit点击标签新增或移除按钮时触发Function

标签页 插槽

名称说明子标签
default自定义默认内容Tab-pane
add-icon自定义新增按钮图标

标签页 暴露

名称说明类型
currentName当前激活面板名称object
tabNavRef标签导航组件实例object

标签导航 API

标签导航 暴露

名称说明类型
scrollToActiveTab滚动到当前激活标签Function
removeFocus移除聚焦状态Function
tabListRefel_tabs__nav DOMobject
tabBarRefel_tabs__nav 指示条实例object

标签条 API

标签条 暴露

名称说明类型
ref标签条根 DOM 元素object
update手动更新标签条样式,返回更新后的样式对象Function

标签面板 API

标签面板 属性

名称说明类型默认值
label标签标题string''
disabled是否禁用该标签booleanfalse
nameTabsname 对应的标识,表示该 tab-pane 的别名;默认按顺序为序号,例如第一个 tab-pane'0'string / number
closable标签是否可关闭booleanfalse
lazy标签是否延迟渲染booleanfalse

标签面板 插槽

名称说明
defaultTab-pane 内容
labelTab-pane 标题

常见问题

如何实现可排序 / 可拖拽的标签页?

我们暴露了实现该能力所需的信息,你可以自行实现。 也可以使用原生方式,参考 示例。 或使用 SortableJs,参考 示例