# Tabs 选项卡切换
### 介绍
常用于平级区域大块内容的的收纳和展现,支持内嵌标签形式和渲染循环数据形式
### 安装
``` javascript
import { createApp } from 'vue';
// vue
import { Tabs, TabPane } from '@nutui/nutui';
// taro
import { Tabs, TabPane } from '@nutui/nutui-taro';
const app = createApp();
app.use(Tabs);
app.use(TabPane);
```
### 基础用法
``` html
Tab 1
Tab 2
Tab 3
```
``` javascript
import { reactive } from 'vue';
export default {
props: {},
setup() {
const state = reactive({
tab1value: '0',
tab11value: '0',
tab2value: '0',
tab3value: '0',
tab4value: '0',
tab5value: '0',
tab6value: '0',
tab7value: 'c1',
list3: Array.from(new Array(2).keys()),
list4: Array.from(new Array(10).keys()),
list5: Array.from(new Array(2).keys()),
list6: [
{
title: '自定义 1',
paneKey: 'c1',
icon: 'dongdong'
},
{
title: '自定义 2',
paneKey: 'c2',
icon: 'JD'
},
{
title: '自定义 3',
paneKey: 'c3'
}
]
});
setTimeout(() => {
state.list3.push(999);
state.tab3value = '2';
}, 3000);
return { state };
}
};
```
### 基础用法-微笑曲线
``` html
Tab 1
Tab 2
Tab 3
```
### 通过 pane-key 匹配
``` html
Tab 1
Tab 2
Tab 3
```
### 数据异步渲染 3s
``` html
Tab {{item}}
```
### 数量多,滚动操作
``` html
Tab {{item}}
```
### 左右布局
``` html
Tab {{item}}
```
### 左右布局-微笑曲线
``` html
Tab {{item}}
```
### 标签栏字体尺寸 large normal small
``` html
Tab 1
Tab 2
Tab 3
Tab 1
Tab 2
Tab 3
Tab 1
Tab 2
Tab 3
```
### 自定义标签栏
``` html
{{item.title}}
{{item.title}}
```
## API
### Tabs Props
| 参数 | 说明 | 类型 | 默认值 |
|---------------|-----------------------------------------------|---------------|------------|
| v-model | 绑定当前选中标签的标识符 | number,string | 0 |
| color | 标签选中色 | string | #1a1a1a |
| background | 标签栏背景颜色 | string | #f5f5f5 |
| direction | 使用横纵方向 可选值 horizontal、vertical | string | horizontal |
| type | 选中底部展示样式 可选值 line、smile | string | line |
| title-scroll | 标签栏是否可以滚动 | boolean | false |
| ellipsis | 是否省略过长的标题文字 | boolean | true |
| animated-time | 切换动画时长,单位 ms 0 代表无动画 | number,string | 300 |
| title-gutter | 标签间隙 | number,string | 0 |
| size`v3.1.13` | 标签栏字体尺寸大小 可选值 large normal small | string | normal |
## Tabs Slots
| 名称 | 说明 |
|---------|----------------|
| titles | 自定义导航区域 |
| default | 自定义内容 |
### Tabpane Props
| 参数 | 说明 | 类型 | 默认值 |
|----------|-------------------------|---------|------------------|
| title | 标题 | string | |
| pane-key | 标签 Key , 匹配的标识符 | string | 默认索引0,1,2... |
| disabled | 是否禁用标签 | boolean | false |
## Tabpane Slots
| 名称 | 说明 |
|---------|------------|
| default | 自定义内容 |
### Tabs Events
| 事件名 | 说明 | 回调参数 |
|--------|--------------------------|--------------------------|
| click | 点击标签时触发 | {title,paneKey,disabled} |
| change | 当前激活的标签改变时触发 | {title,paneKey,disabled} |