Tabs
Divide data collections which are related yet belong to different types.
Basic usage
Basic and concise tabs.
Tabs provide a selective card functionality. By default the first tab is selected as active, and you can activate any tab by setting the value
attribute.
Card Style
Tabs styled as cards.
Set type
to card
can get a card-styled tab.
Border card
Border card tabs.
Set type
to border-card
.
Tab position
You can use tab-position
attribute to set the tab's position.
You can choose from four directions: tabPosition="left|right|top|bottom"
Custom Tab
You can use named slot to customize the tab label content.
Add & close tab
Only card type Tabs support addable & closeable.
Customized add button icon 2.4.0
Customized trigger button of new tab
Tabs API
Tabs Attributes
Name | Description | Type | Default |
---|---|---|---|
model-value / v-model | binding value, name of the selected tab, the default value is the name of first tab | string / number | — |
type | type of Tab | enum | '' |
closable | whether Tab is closable | boolean | false |
addable | whether Tab is addable | boolean | false |
editable | whether Tab is addable and closable | boolean | false |
tab-position | position of tabs | enum | top |
stretch | whether width of tab automatically fits its container | boolean | false |
before-leave | hook function before switching tab. If false is returned or a Promise is returned and then is rejected, switching will be prevented | Function | () => true |
Tabs Events
Name | Description | Parameters |
---|---|---|
tab-click | triggers when a tab is clicked | Function |
tab-change | triggers when activeName is changed | Function |
tab-remove | triggers when tab-remove button is clicked | Function |
tab-add | triggers when tab-add button is clicked | Function |
edit | triggers when tab-add button or tab-remove is clicked | Function |
Tabs Slots
Name | Description | Subtags |
---|---|---|
default | customize default content | Tab-pane |
add-icon 2.5.4 | customize add button icon | — |
addIcon 2.4.0 deprecated | customize add button icon | — |
Tab-pane API
Tab-pane Attributes
Name | Description | Type | Default |
---|---|---|---|
label | title of the tab | string | '' |
disabled | whether Tab is disabled | boolean | false |
name | identifier corresponding to the name of Tabs, representing the alias of the tab-pane, the default is ordinal number of the tab-pane in the sequence, e.g. the first tab-pane is '0' | string / number | — |
closable | whether Tab is closable | boolean | false |
lazy | whether Tab is lazily rendered | boolean | false |
Tab-pane Slots
Name | Description |
---|---|
default | Tab-pane's content |
label | Tab-pane's label |