Tabs that switch between content panels. Add one Tab and one Tab panel for each. The full ARIA tabs pattern: arrow keys move between tabs, and the selected state is announced.
Live example
These are real Tabs blocks rendering on this page right now. Tab to them and try them in both color schemes.
Active panel.
Inactive panel.
Inactive panel.
Inactive panel.
Disabled panel.
Account panel — manage username, avatar, and profile settings.
Notifications panel — email and in-app preferences.
Billing panel — invoices, payment methods, plan tier.
Security panel — password, 2FA, active sessions.
Dark mode you don’t have to build
Every block supports dark mode. Use the light/dark toggle in the header and the live example above switches with it.
Parameters
Everything the Tabs block accepts. Setting is the label you see in the block’s settings panel. Parameter is what the same value is called in code. Accepts is what you can put in it.
| Setting | Parameter | Type | Default | Accepts | What it does |
|---|---|---|---|---|---|
| Orientation | orientation | string | “horizontal” | horizontal, vertical | Lay the items out in a row or a column. |
| Accessible name (aria-label) | ariaLabel | string | “Tabs” | Any text | The accessible name screen readers announce for this landmark or control. |
Inside it: Tab
One tab button. It shows the panel in the same position.
| Setting | Parameter | Type | Default | Accepts | What it does |
|---|---|---|---|---|---|
| Typed on the block | label | string | “Tab” | Any text | The tab’s visible text. |
| Disabled | disabled | boolean | false | true or false | Renders the disabled state. Disabled controls are skipped by keyboard focus, so prefer hiding over disabling when you can. |
Inside it: Tab panel
The panel shown by the tab in the same position.
It has no parameters of its own.
Accessibility parameters, on this and every AWT block
Every AWT block has an Accessibility panel in its settings. Each control in it becomes a real HTML attribute on the block’s outer element:
| Setting | Parameter | What it does |
|---|---|---|
| Accessible name (aria-label) | ariaLabel | Becomes aria-label on the block’s outer element. Replaces the accessible name screen readers announce. Set it only when the visible label is not enough. |
| Described by (aria-describedby) | ariaDescribedby | Becomes aria-describedby. Point it at the ID of another element on the page whose text adds a longer description. |
| Labelled by (aria-labelledby) | ariaLabelledby | Becomes aria-labelledby. Point it at the ID of another element whose text should become this block’s accessible name. |
| Role | awtRole | Becomes the role attribute. Overrides the element’s ARIA role. The list offers only roles that suit the element. |
| Language (lang) | awtLang | Becomes the lang attribute. Set it when this block’s content is in a different language from the page, as a BCP-47 code like “fr”. |