element/examples/docs/zh-CN/tabs.md

150 lines
4.6 KiB
Markdown
Raw Normal View History

2016-07-27 14:15:02 +08:00
<script>
export default {
data() {
return {
activeName: 'first',
2016-11-04 11:28:23 +08:00
tabs: [
2016-11-09 18:56:50 +08:00
{label: '用户管理', content: '', name: 'first'},
{label: '配置管理', content: '', name: 'second'},
{label: '角色管理', content: '', name: 'third'},
{label: '定时任务补偿', content: '', name: 'last'}
2016-11-04 11:28:23 +08:00
]
2016-07-27 14:15:02 +08:00
}
2016-08-22 12:42:47 +08:00
},
methods: {
handleRemove(tab) {
console.log(tab);
},
2016-08-22 12:42:47 +08:00
handleClick(tab, event) {
console.log(tab, event);
2016-08-22 12:42:47 +08:00
}
2016-07-27 14:15:02 +08:00
}
}
</script>
## Tabs 标签页
分隔内容上有关联但属于不同类别的数据集合。
2016-07-27 14:15:02 +08:00
2016-09-06 12:47:25 +08:00
### 基础用法
基础的、简洁的标签页。
2016-07-27 14:15:02 +08:00
:::demo Tabs 组件提供了选项卡功能,只需要使用`el-tabs`和子元素`el-tab-pane`即可,在两个元素中,我们分别提供了一系列的属性来方便使用,`el-tab-pane`中`label`决定了选项卡标题,标签内部写入内容即可。在下例中我们在`el-tabs`中设置了`active-name`属性,接受一个`String`值,表明选中的选项卡,在`el-tab-pane`中可以设置对应的`name`属性,如果没有设置`name`,则默认值为顺序的`1`/`2`/`3`/`4`。例子选中选项卡2如果不设置`name`,将`active-name`设为`2`,可以达成相同效果。
2016-07-27 14:15:02 +08:00
```html
2016-08-22 17:18:00 +08:00
<template>
2016-11-08 17:32:37 +08:00
<el-tabs :active-name="activeName">
<el-tab-pane v-for="tab in tabs" :label="tab.label" :name="tab.name">{{tab.content}}</el-tab-pane>
2016-08-22 17:18:00 +08:00
</el-tabs>
</template>
<script>
export default {
data() {
return {
2016-11-13 11:58:45 +08:00
activeName: 'first',
2016-11-04 11:28:23 +08:00
tabs: [
2016-11-08 17:32:37 +08:00
{label: '用户管理', content: '', name: 'first'},
{label: '配置管理', content: '', name: 'second'},
{label: '角色管理', content: '', name: 'third'},
{label: '定时任务补偿', content: '', name: 'last'}
2016-11-04 11:28:23 +08:00
]
2016-08-22 17:18:00 +08:00
};
}
};
</script>
2016-07-27 14:15:02 +08:00
```
:::
2016-07-27 14:15:02 +08:00
2016-09-06 12:47:25 +08:00
### 选项卡样式
2016-08-22 17:18:00 +08:00
2016-09-06 12:47:25 +08:00
选项卡样式的标签页。
2016-07-27 14:15:02 +08:00
2016-09-06 12:47:25 +08:00
:::demo 只需要设置`type`属性即可,如果需要标签风格,将其设置为`card`。
2016-07-27 14:15:02 +08:00
2016-09-06 12:47:25 +08:00
```html
<template>
<el-tabs type="card" @tab-click="handleClick" @tab-remove="handleRemove">
<el-tab-pane label="用户管理"></el-tab-pane>
<el-tab-pane label="配置管理"></el-tab-pane>
<el-tab-pane label="角色管理"></el-tab-pane>
<el-tab-pane label="定时任务补偿"></el-tab-pane>
2016-09-06 12:47:25 +08:00
</el-tabs>
</template>
<script>
export default {
methods: {
handleRemove(tab) {
console.log(tab);
},
2016-11-13 11:58:45 +08:00
handleClick(tab, event) {
console.log(tab, event);
2016-09-06 12:47:25 +08:00
}
}
};
</script>
2016-07-27 14:15:02 +08:00
```
:::
2016-07-27 14:15:02 +08:00
2016-09-06 12:47:25 +08:00
### 可关闭
可以关闭标签页。
2016-08-22 17:18:00 +08:00
:::demo 在`el-tabs`中设置`closable`属性,接受一个`Boolean`,设置为`true`时为可关闭。
2016-07-27 14:15:02 +08:00
```html
2016-08-22 17:18:00 +08:00
<template>
<el-tabs type="card" :closable="true" @tab-click="handleClick" @tab-remove="handleRemove">
<el-tab-pane label="用户管理"></el-tab-pane>
<el-tab-pane label="配置管理"></el-tab-pane>
<el-tab-pane label="角色管理"></el-tab-pane>
<el-tab-pane label="定时任务补偿"></el-tab-pane>
2016-08-22 17:18:00 +08:00
</el-tabs>
</template>
<script>
export default {
methods: {
handleRemove(tab) {
console.log(tab);
},
2016-11-13 11:58:45 +08:00
handleClick(tab, event) {
console.log(tab, event);
2016-08-22 17:18:00 +08:00
}
}
};
</script>
2016-09-06 12:47:25 +08:00
```
:::
### 卡片化
卡片化的标签页。
:::demo 将`type`设置为`border-card`。
```html
<el-tabs type="border-card">
<el-tab-pane label="用户管理"></el-tab-pane>
<el-tab-pane label="配置管理"></el-tab-pane>
<el-tab-pane label="角色管理"></el-tab-pane>
<el-tab-pane label="定时任务补偿"></el-tab-pane>
2016-09-06 12:47:25 +08:00
</el-tabs>
2016-07-27 14:15:02 +08:00
```
:::
2016-07-27 14:15:02 +08:00
### Tabs Attributes
2016-07-27 14:15:02 +08:00
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------- |---------- |------------- |-------- |
2016-11-13 11:58:45 +08:00
| type | 风格类型 | string | card/border-card | — |
| closable | 标签是否可关闭 | boolean | — | false |
2016-09-28 15:20:50 +08:00
| active-name | 选中选项卡的 name | string | — | 第一个选项卡的 name |
2016-07-27 14:15:02 +08:00
### Tabs Events
2016-08-23 15:24:26 +08:00
| 事件名称 | 说明 | 回调参数 |
|---------- |-------- |---------- |
2016-10-24 14:57:07 +08:00
| tab-click | tab 被选中的钩子 | 被选中的标签 tab 实例 |
| tab-remove | tab 被删除的钩子 | 被删除的标签 tab 实例 |
2016-08-23 15:24:26 +08:00
### Tab-pane Attributes
2016-07-27 14:15:02 +08:00
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------- |---------- |------------- |-------- |
2016-09-02 13:56:47 +08:00
| label | 选项卡标题 | string | — | — |
2016-09-28 15:20:50 +08:00
| name | 与选项卡 activeName 对应的标识符,表示选项卡别名 | string | — | 该选项卡在选项卡列表中的顺序值,如第一个选项卡则为'1' |