Tabs 标签页

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

基础用法

基础的、简洁的标签页。

标签页提供可选择的卡片功能。 默认情况下,第一个标签页被选为激活状态,你可以通过设置 value 属性来激活任意标签页。

用户

选项卡样式

选项卡样式的标签页。

设置 type 属性为 card 就可以得到选项卡样式的标签页。

用户

卡片化

卡片化的标签页。

type 设置为 border-card

位置

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

有四个方向可以设置:tabPosition="left|right|top|bottom"

自定义标签页

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

增加和关闭标签页

只有选项卡类型的标签页支持可增加和可关闭。

标签页 2 内容

自定义增加按钮图标 2.4.0

标签页 2 内容

自定义新增标签页触发器

标签页 2 内容

默认值 2.11.9

默认值:第三个
激活

Tabs 接口

Tabs 属性

名称描述类型默认值
model-value / v-model绑定值,选中标签页的名称,默认值为第一个标签页的名称string / number
default-value 2.11.9初始渲染时应该激活的标签页的值(避免初始过渡)。string / number
type标签页类型枚举''
可关闭标签页是否可关闭booleanfalse
addable标签页是否可增加booleanfalse
可编辑标签页是否可增加和关闭booleanfalse
tab-position标签页位置枚举
stretch标签页宽度是否自适应容器booleanfalse
before-leave切换标签页之前的钩子函数。 若返回 false 或者返回 Promise 且被 reject,则阻止切换。Function() => true
tabindex 2.11.7标签页的 tabindexstring / number0

Tabs 事件

名称描述参数
tab-click点击标签页时触发Function
tab-changeactiveName 改变时触发Function
tab-remove点击标签页删除按钮时触发Function
tab-add点击标签页增加按钮时触发Function
edit点击标签页增加按钮或删除按钮时触发Function

Tabs 插槽

名称描述子标签
default自定义默认内容标签面板 (Tab-pane)
add-icon 2.5.4自定义增加按钮图标
addIcon 2.4.0 已废弃自定义增加按钮图标

Tabs 暴露

名称描述类型
currentName当前激活面板的名称object
tabNavRef 2.9.10tab-nav 组件实例object

Tab-nav 接口

Tab-nav 暴露

名称描述类型
scrollToActiveTab滚动到当前激活的标签页Function
removeFocus移除焦点状态Function
tabListRef 2.9.10el_tabs__nav HTML 元素object
tabBarRef 2.9.10el_tabs__nav 条目实例object

Tab-bar 接口

Tab-bar 暴露

名称描述类型
ref 2.9.10标签页根 HTML 元素object
update 2.9.10手动更新标签页条目样式的方法,返回更新后的样式Function

Tab-pane 接口

Tab-pane 属性

名称描述类型默认值
label标签页标题string''
disabled是否禁用booleanfalse
名称对应 Tabs 的 name 的标识符,代表标签面板的别名,默认值为标签面板在序列中的序号,如第一个标签面板为 '0'string / number
可关闭标签页是否可关闭booleanfalse
lazy标签页是否延迟渲染booleanfalse

Tab-pane 插槽

名称描述
default标签面板的内容
label标签面板的标题

常见问题

如何使用可排序/可拖拽的标签页?

我们暴露了必要的信息供您自行实现。 您可以使用原生方式,如 示例。 或使用 SortableJs,如 示例

来源

组件样式文档

贡献者