标签
划分相关但属于不同类型的数据集合。
基本用法
基本而简洁的选项卡。
选项卡提供选择性卡片功能。默认情况下,第一个选项卡被选择为活动选项卡,您可以通过设置 value 属性来激活任何选项卡。
卡片风格
选项卡样式为卡片。
将 type 设置为 card 可以获得卡片式选项卡。
边境卡
边框卡标签。
将 type 设置为 border-card。
制表符位置
您可以使用 tab-position 属性来设置选项卡的位置。
您可以选择四个方向: tabPosition="left|right|top|bottom"
自定义选项卡
您可以使用命名槽来自定义选项卡标签内容。
添加并关闭选项卡
仅卡片类型选项卡支持可添加和可关闭。
自定义添加按钮图标2.4.0
自定义新标签页触发按钮
默认值 2.11.9
标签 API
选项卡属性
| 名称 | 描述 | 类型 | 默认 |
|---|---|---|---|
| 模型值 / v 模型 | 绑定值,所选选项卡的名称,默认值为第一个选项卡的名称 | 字符串 / 数字 | — |
| 默认值 2.11.9 | 初始呈现时应处于活动状态的选项卡的值。 (避免初始转换) | 字符串 / 数字 | — |
| 类型 | 标签类型 | 枚举 | '' |
| 可关闭 | Tab 是否可关闭 | 布尔值 | 假 |
| 可添加 | 是否可添加 Tab | 布尔值 | 假 |
| 可编辑 | Tab 是否可添加和可关闭 | 布尔值 | 假 |
| 制表位 | 选项卡的位置 | 枚举 | 顶部 |
| 拉伸 | 选项卡的宽度是否自动适合其容器 | 布尔值 | 假 |
| 出发前 | 切换选项卡之前的钩子函数。如果返回 false 或返回 Promise 然后被拒绝,将阻止切换 | 功能 | () => 真 |
| 制表索引 2.11.7 | 选项卡字符串 / 数字 | 0 |
标签事件
| 名称 | 描述 | 参数 |
|---|---|---|
| 单击 Tab 键 | 单击选项卡时触发 | 功能 |
| 制表符更改 | 当 activeName 更改时触发 | 功能 |
| 制表符删除 | 单击选项卡删除按钮时触发 | 功能 |
| 选项卡添加 | 单击选项卡添加按钮时触发 | 功能 |
| 编辑 | 单击选项卡添加按钮或选项卡删除按钮时触发 | 功能 |
标签槽
| 名称 | 描述 | 子标签 |
|---|---|---|
| 默认 | 自定义默认内容 | 选项卡窗格 |
| 添加图标 2.5.4 | 自定义添加按钮图标 | — |
| addIcon 2.4.0 已弃用 | 自定义添加按钮图标 | — |
标签暴露
| 名称 | 描述 | 类型 |
|---|---|---|
| 当前姓名 | 当前活动窗格名称 | 对象 |
| tabNavRef 2.9.10 | 选项卡导航组件实例 | 对象 |
标签导航 API
标签导航暴露
|名称 |描述 |类型 | | -------------------- | ------------------------ | | ------------------------------------------- | |滚动到活动选项卡 |滚动到活动选项卡 | 功能 | |删除焦点 |移除焦点状态 | 功能 | | tabListRef 2.9.10 | el_tabs__nav html 元素 | 对象 | | tabBarRef 2.9.10 | el_tabs__nav 栏实例 | 对象 |
选项卡窗格 API
选项卡窗格属性
| 名称 | 描述 | 类型 | 默认 |
|---|---|---|---|
| 标签 | 选项卡标题 | 字符串 | '' |
| 已禁用 | Tab 是否被禁用 | 布尔值 | 假 |
| 名称 | 与选项卡名称对应的标识符,代表选项卡窗格的别名,默认为选项卡窗格在序列中的序号,例如第一个选项卡窗格是“0” | 字符串 / 数字 | — |
| 可关闭 | Tab 是否可关闭 | 布尔值 | 假 |
| 懒惰 | Tab 是否延迟渲染 | 布尔值 | 假 |
选项卡窗格插槽
| 名称 | 描述 |
|---|---|
| 默认 | 选项卡窗格的内容 |
| 标签 | 选项卡窗格的标签 |
类型声明
显示声明
ts
type TabBarInstance = InstanceType<typeof TabBar> & {
/** @description tab root html element */
ref: barRef
/** @description method to manually update tab bar style */
update
}常见问题解答
如何使用可排序/可拖动选项卡?
我们公开了自行实施所需的信息。 您可以使用本机方式来完成此操作,演示。 或者使用SortableJs、演示。