Tabs 标签页
分隔内容上有关联但属于不同类别的数据集合。
基础用法
基础的、简洁的标签页。
标签页提供可选择的卡片功能。 默认情况下,第一个标签页被选为激活状态,你可以通过设置 value 属性来激活任意标签页。
选项卡样式
选项卡样式的标签页。
设置 type 属性为 card 就可以得到选项卡样式的标签页。
卡片化
卡片化的标签页。
将 type 设置为 border-card。
位置
可以通过 tab-position 设置标签页的位置。
有四个方向可以设置:tabPosition="left|right|top|bottom"
自定义标签页
可以通过具名插槽来自定义标签页的内容。
增加和关闭标签页
只有选项卡类型的标签页支持可增加和可关闭。
自定义增加按钮图标 2.4.0
自定义新增标签页触发器
默认值 2.11.9
Tabs 接口
Tabs 属性
| 名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值,选中标签页的名称,默认值为第一个标签页的名称 | string / number | — |
| default-value 2.11.9 | 初始渲染时应该激活的标签页的值(避免初始过渡)。 | string / number | — |
| type | 标签页类型 | 枚举 | '' |
| 可关闭 | 标签页是否可关闭 | boolean | false |
| addable | 标签页是否可增加 | boolean | false |
| 可编辑 | 标签页是否可增加和关闭 | boolean | false |
| tab-position | 标签页位置 | 枚举 | 上 |
| stretch | 标签页宽度是否自适应容器 | boolean | false |
| before-leave | 切换标签页之前的钩子函数。 若返回 false 或者返回 Promise 且被 reject,则阻止切换。 | Function | () => true |
| tabindex 2.11.7 | 标签页的 tabindex | string / number | 0 |
Tabs 事件
| 名称 | 描述 | 参数 |
|---|---|---|
| tab-click | 点击标签页时触发 | Function |
| tab-change | activeName 改变时触发 | 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.10 | tab-nav 组件实例 | object |
Tab-nav 接口
Tab-nav 暴露
| 名称 | 描述 | 类型 |
|---|---|---|
| scrollToActiveTab | 滚动到当前激活的标签页 | Function |
| removeFocus | 移除焦点状态 | Function |
| tabListRef 2.9.10 | el_tabs__nav HTML 元素 | object |
| tabBarRef 2.9.10 | el_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 | 是否禁用 | boolean | false |
| 名称 | 对应 Tabs 的 name 的标识符,代表标签面板的别名,默认值为标签面板在序列中的序号,如第一个标签面板为 '0' | string / number | — |
| 可关闭 | 标签页是否可关闭 | boolean | false |
| lazy | 标签页是否延迟渲染 | boolean | false |
Tab-pane 插槽
| 名称 | 描述 |
|---|---|
| default | 标签面板的内容 |
| label | 标签面板的标题 |
常见问题
如何使用可排序/可拖拽的标签页?
我们暴露了必要的信息供您自行实现。 您可以使用原生方式,如 示例。 或使用 SortableJs,如 示例。