Tabs 标签页

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

基础用法

基础简洁的标签页。

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

用户

卡片风格

卡片化的标签页。

type 设置为 card 就可以使选项卡改变为标签风格。

用户

带边框的卡片

带边框的卡片化标签。

设置 type 属性为 border-card

标签位置

您可以使用 tab-position 属性设置标签的位置。

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

自定义标签页

您可以使用具名插槽来定制标签页的内容。

增加和关闭标签页

只有卡片样式的标签页支持增加和关闭选项。

标签页 2 的内容

自定义添加按钮图标 2.4.0

标签页 2 的内容

自定义新标签页的触发器

标签页 2 的内容

Tabs API

Tabs 属性

名称描述类型默认值
model-value / v-model绑定值,选中选项卡的 name,默认值为第一个选项卡的 namestring / number
type标签页的类型枚举''
可关闭标签是否可关闭booleanfalse
可增加的标签页是否可增加booleanfalse
可编辑标签页是否可增加和关闭booleanfalse
tab-position选项卡所在位置枚举
stretch标签的宽度是否自撑开booleanfalse
before-leave切换标签之前的钩子,若返回 false 或者返回 Promise 且被 reject,则阻止切换Function() => true

Tabs 事件

名称描述参数
tab-clicktab 被选中时触发Function
tab-changeactiveName 改变时触发Function
tab-remove点击 tab 移除按钮后触发Function
tab-add点击 tab 新增按钮后触发Function
edit点击 tab 新增按钮或移除按钮后触发Function

Tabs 插槽

名称描述子标签
default自定义默认内容标签页
add-icon 2.5.4自定义添加按钮图标
addIcon 2.4.0 已废弃自定义添加按钮图标

Tabs Exposes

名称描述类型
currentName当前活动的 pane 的 nameobject
tabNavRef 2.9.10tab-nav 组件实例object

Tab-nav API

Tab-nav Exposes

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

Tab-pane API

Tab-pane 属性

名称描述类型默认值
label选项卡标题string''
disabled该选项卡是否被禁用booleanfalse
名称与选项卡绑定值 value 对应的标识符,表示选项卡别名,默认为选项卡在序列中的序号,如第一个选项卡为“0”string / number
可关闭标签是否可关闭booleanfalse
lazy标签是否延迟渲染booleanfalse

Tab-pane 插槽

名称描述
default标签页的内容
label标签页的标签

类型声明

显示声明
ts
type TabBarInstance = InstanceType<typeof TabBar> & {
  /** @description tab root html element */
  ref: barRef
  /** @description method to manually update tab bar style */
  update
}

来源

组件样式文档

贡献者