# tabs<a name="ZH-CN_TOPIC_0000001209252163"></a>

-   [权限列表](#zh-cn_topic_0000001173324585_section11257113618419)
-   [子组件](#zh-cn_topic_0000001173324585_section9288143101012)
-   [属性](#zh-cn_topic_0000001173324585_section2907183951110)
-   [样式](#zh-cn_topic_0000001173324585_section169548171376)
-   [事件](#zh-cn_topic_0000001173324585_section3892191911214)
-   [示例](#zh-cn_topic_0000001173324585_section14993155318710)

tab页签容器。

## 权限列表<a name="zh-cn_topic_0000001173324585_section11257113618419"></a>

无

## 子组件<a name="zh-cn_topic_0000001173324585_section9288143101012"></a>

仅支持最多一个<[tab-bar](js-components-container-tab-bar.md#ZH-CN_TOPIC_0000001164130760)\>和最多一个<[tab-content](js-components-container-tab-content.md#ZH-CN_TOPIC_0000001164290710)\>。

## 属性<a name="zh-cn_topic_0000001173324585_section2907183951110"></a>

除支持[通用属性](js-components-common-attributes.md#ZH-CN_TOPIC_0000001163812208)外，还支持如下属性：

<a name="zh-cn_topic_0000001173324585_table20633101642315"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001173324585_row663331618238"><th class="cellrowborder" valign="top" width="23.119999999999997%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001173324585_aa872998ac2d84843a3c5161889afffef"><a name="zh-cn_topic_0000001173324585_aa872998ac2d84843a3c5161889afffef"></a><a name="zh-cn_topic_0000001173324585_aa872998ac2d84843a3c5161889afffef"></a>名称</p>
</th>
<th class="cellrowborder" valign="top" width="23.119999999999997%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001173324585_ab2111648ee0e4f6d881be8954e7acaab"><a name="zh-cn_topic_0000001173324585_ab2111648ee0e4f6d881be8954e7acaab"></a><a name="zh-cn_topic_0000001173324585_ab2111648ee0e4f6d881be8954e7acaab"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.48%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001173324585_ab377d1c90900478ea4ecab51e9a058af"><a name="zh-cn_topic_0000001173324585_ab377d1c90900478ea4ecab51e9a058af"></a><a name="zh-cn_topic_0000001173324585_ab377d1c90900478ea4ecab51e9a058af"></a>默认值</p>
</th>
<th class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001173324585_p824610360217"><a name="zh-cn_topic_0000001173324585_p824610360217"></a><a name="zh-cn_topic_0000001173324585_p824610360217"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="35.76%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001173324585_a1d574a0044ed42ec8a2603bc82734232"><a name="zh-cn_topic_0000001173324585_a1d574a0044ed42ec8a2603bc82734232"></a><a name="zh-cn_topic_0000001173324585_a1d574a0044ed42ec8a2603bc82734232"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001173324585_row188481425182510"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324585_p1123011311254"><a name="zh-cn_topic_0000001173324585_p1123011311254"></a><a name="zh-cn_topic_0000001173324585_p1123011311254"></a>index</p>
</td>
<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324585_p1223193122517"><a name="zh-cn_topic_0000001173324585_p1223193122517"></a><a name="zh-cn_topic_0000001173324585_p1223193122517"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324585_p1523183172515"><a name="zh-cn_topic_0000001173324585_p1523183172515"></a><a name="zh-cn_topic_0000001173324585_p1523183172515"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324585_p623183182516"><a name="zh-cn_topic_0000001173324585_p623183182516"></a><a name="zh-cn_topic_0000001173324585_p623183182516"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324585_p13231103192517"><a name="zh-cn_topic_0000001173324585_p13231103192517"></a><a name="zh-cn_topic_0000001173324585_p13231103192517"></a>当前处于激活态的tab索引。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001173324585_row0461622112513"><td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001173324585_p12311131122516"><a name="zh-cn_topic_0000001173324585_p12311131122516"></a><a name="zh-cn_topic_0000001173324585_p12311131122516"></a>vertical</p>
</td>
<td class="cellrowborder" valign="top" width="23.119999999999997%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001173324585_p423110319253"><a name="zh-cn_topic_0000001173324585_p423110319253"></a><a name="zh-cn_topic_0000001173324585_p423110319253"></a>boolean</p>
</td>
<td class="cellrowborder" valign="top" width="10.48%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001173324585_p1023118318252"><a name="zh-cn_topic_0000001173324585_p1023118318252"></a><a name="zh-cn_topic_0000001173324585_p1023118318252"></a>false</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001173324585_p42311331102516"><a name="zh-cn_topic_0000001173324585_p42311331102516"></a><a name="zh-cn_topic_0000001173324585_p42311331102516"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="35.76%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001173324585_p10231123114251"><a name="zh-cn_topic_0000001173324585_p10231123114251"></a><a name="zh-cn_topic_0000001173324585_p10231123114251"></a>是否为纵向的tab，默认为false，可选值为：</p>
<a name="zh-cn_topic_0000001173324585_ul8231123114251"></a><a name="zh-cn_topic_0000001173324585_ul8231123114251"></a><ul id="zh-cn_topic_0000001173324585_ul8231123114251"><li>false：tabbar和tabcontent上下排列。</li><li>true：tabbar和tabcontent左右排列。</li></ul>
</td>
</tr>
</tbody>
</table>

## 样式<a name="zh-cn_topic_0000001173324585_section169548171376"></a>

支持[通用样式](js-components-common-styles.md#ZH-CN_TOPIC_0000001163932190)。

## 事件<a name="zh-cn_topic_0000001173324585_section3892191911214"></a>

除支持[通用事件](js-components-common-events.md#ZH-CN_TOPIC_0000001209412119)外，还支持如下事件：

<a name="zh-cn_topic_0000001173324585_table836435619510"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001173324585_row153658563517"><th class="cellrowborder" valign="top" width="24.852485248524854%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001173324585_a426b8903842d48fa8012a24ff3c997eb"><a name="zh-cn_topic_0000001173324585_a426b8903842d48fa8012a24ff3c997eb"></a><a name="zh-cn_topic_0000001173324585_a426b8903842d48fa8012a24ff3c997eb"></a>名称</p>
</th>
<th class="cellrowborder" valign="top" width="29.552955295529554%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001173324585_a53448ba47e5e4ae9bf7774c90820e970"><a name="zh-cn_topic_0000001173324585_a53448ba47e5e4ae9bf7774c90820e970"></a><a name="zh-cn_topic_0000001173324585_a53448ba47e5e4ae9bf7774c90820e970"></a>参数</p>
</th>
<th class="cellrowborder" valign="top" width="45.5945594559456%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001173324585_add489ff50c444f24b759162c7f4bad9a"><a name="zh-cn_topic_0000001173324585_add489ff50c444f24b759162c7f4bad9a"></a><a name="zh-cn_topic_0000001173324585_add489ff50c444f24b759162c7f4bad9a"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001173324585_row4918151132616"><td class="cellrowborder" valign="top" width="24.852485248524854%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001173324585_p661018582267"><a name="zh-cn_topic_0000001173324585_p661018582267"></a><a name="zh-cn_topic_0000001173324585_p661018582267"></a>change</p>
</td>
<td class="cellrowborder" valign="top" width="29.552955295529554%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001173324585_p15610135815262"><a name="zh-cn_topic_0000001173324585_p15610135815262"></a><a name="zh-cn_topic_0000001173324585_p15610135815262"></a>{ index: indexValue }</p>
</td>
<td class="cellrowborder" valign="top" width="45.5945594559456%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001173324585_p161015852613"><a name="zh-cn_topic_0000001173324585_p161015852613"></a><a name="zh-cn_topic_0000001173324585_p161015852613"></a>tab页签切换后触发。</p>
<div class="note" id="zh-cn_topic_0000001173324585_note1551155885118"><a name="zh-cn_topic_0000001173324585_note1551155885118"></a><a name="zh-cn_topic_0000001173324585_note1551155885118"></a><span class="notetitle"> 说明： </span><div class="notebody"><p id="zh-cn_topic_0000001173324585_p1251125818519"><a name="zh-cn_topic_0000001173324585_p1251125818519"></a><a name="zh-cn_topic_0000001173324585_p1251125818519"></a>动态修改index值不会触发该回调。</p>
</div></div>
</td>
</tr>
</tbody>
</table>

## 示例<a name="zh-cn_topic_0000001173324585_section14993155318710"></a>

```
<!-- xxx.hml -->
<div class="container">
  <tabs class = "tabs" index="0" vertical="false" onchange="change">
    <tab-bar class="tab-bar" mode="fixed">
      <text class="tab-text">Home</text>
      <text class="tab-text">Index</text>
      <text class="tab-text">Detail</text>
    </tab-bar>
    <tab-content class="tabcontent" scrollable="true">
      <div class="item-content" >
        <text class="item-title">First screen</text>
      </div>
      <div class="item-content" >
        <text class="item-title">Second screen</text>
      </div>
      <div class="item-content" >
        <text class="item-title">Third screen</text>
      </div>
    </tab-content>
  </tabs>
</div>
```

```
/* xxx.css */
.container {
  flex-direction: column;
  justify-content: flex-start;
  align-items: center;
}
.tabs {
  width: 100%;
}
.tabcontent {
  width: 100%;
  height: 80%;
  justify-content: center;
}
.item-content {
  height: 100%;
  justify-content: center;
}
.item-title {
  font-size: 60px;
}
.tab-bar {
  margin: 10px;
  height: 60px;
  border-color: #007dff;
  border-width: 1px;
}
.tab-text {
  width: 300px;
  text-align: center;
}
```

```
// xxx.js
export default {
  change: function(e) {
    console.log("Tab index: " + e.index);
  },
}
```

![](figures/tab.gif)