You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tabs make it easy to switch between different views.
When To Use
Ant Design has 3 types of Tabs for different situations.
- Card Tabs: for managing too many closeable views.
- Normal Tabs: for functional aspects of a page.
- RadioButton: for secondary tabs.
API
Tabs
Property |
Description |
Type |
Default |
Version |
activeKey(v-model) |
Current TabPane's key |
string |
- |
|
animated |
Whether to change tabs with animation. Only works while tabPosition="top"|"bottom" |
boolean | {inkBar:boolean, tabPane:boolean} |
true , false when type="card" |
|
hideAdd |
Hide plus icon or not. Only works while type="editable-card" |
boolean |
false |
} |
size |
preset tab bar size |
large | default | small |
default |
|
tabBarStyle |
Tab bar style object |
object |
- |
|
tabPosition |
Position of tabs |
top | right | bottom | left |
top |
|
type |
Basic style of tabs |
line | card | editable-card |
line |
|
tabBarGutter |
The gap between tabs |
number |
- |
|
Tabs Slots
Slot Name |
Description |
Type |
|
renderTabBar |
Replace the TabBar |
{ DefaultTabBar } |
|
leftExtra |
Extra content in tab bar left |
- |
- |
rightExtra |
Extra content in tab bar right |
- |
- |
addIcon |
Customize add icon |
- |
- |
moreIcon |
The custom icon of ellipsis |
- |
- |
Tabs Events
Events Name |
Description |
Arguments |
change |
Callback executed when active tab is changed |
Function(activeKey) {} |
edit |
Callback executed when tab is added or removed. Only works while type="editable-card" |
(targetKey, action): void |
nextClick |
Callback executed when next button is clicked |
Function |
prevClick |
Callback executed when prev button is clicked |
Function |
tabClick |
Callback executed when tab is clicked |
Function |
Tabs.TabPane
Property |
Description |
Type |
Default |
forceRender |
Forced render of content in tabs, not lazy render after clicking on tabs |
boolean |
false |
key |
TabPane's key |
string |
- |
tab |
Show text in TabPane's head |
string|slot |
- |
Tabs.TabPane Slots
插槽名称 |
说明 |
参数 |
closeIcon |
自定义关闭图标,在 type="editable-card" 时有效 |
- |
tab |
Show text in TabPane's head |
- |