Tabs
#
Tabs are a set of layered sections of content, known as tab panels, that display one panel of content at a time.
Import
#
import { Tabs } from 'rsuite';
Accessibility
#
ARIA properties
#
- Role
tablist
is added to the container element.
aria-orientation
is set to vertical
when vertical
is true
.
- Role
tab
is added to each tab element.
aria-selected
is set to true
when activeKey
is the same as eventKey
.
aria-disabled
is set to true
when disabled
is true
.
aria-controls
is set to the id
of the corresponding tabpanel.
- Role
tabpanel
is added to each panel element.
aria-labelledby
is set to the id
of the corresponding tab.
aria-hidden
is set to true
when activeKey
is not the same as eventKey
.
Keyboard interactions
#
- โ - moves focus to the previous tab, and activates it.
- โ - moves focus to the next tab, and activates it.
- โ - moves focus to the previous tab, and activates it. (vertical mode only)
- โ - moves focus to the next tab, and activates it. (vertical mode only)
- Home - moves focus to the first tab, and activates it.
- End - moves focus to the last tab, and activates it.
Resources
#
Props
#
<Tabs>
#
Property |
Type (Default) |
Description |
activeKey |
string |
The eventKey of the active tab. |
appearance |
'tabs' | 'subtle' ('tabs') |
The tabs appearance style. |
children |
ChildrenArray<Tabs.Tab> |
The contents of the component. |
classPrefix |
string ('tabs') |
The prefix of the component CSS class. |
defaultActiveKey |
string |
The eventKey of the active tab by default. |
onSelect |
(eventKey: string, event) => void |
Callback function triggered after selection. |
reversed |
boolean |
Reversed display. |
vertical |
boolean |
Whether to display the component vertically. |
<Tabs.Tab>
#
Property |
Type (Default) |
Description |
children |
ReactNode |
The contents of the component. |
disabled |
boolean |
Whether the item is disabled. |
eventKey |
string |
The value of the current item. |
icon |
Element<typeof Icon> |
Sets the icon for the component. |
title * |
ReactNode |
Sets the title for the component. |