Tabs, TabsList, TabsTab, and TabsPanel components let you divide related content into labelled sections the user can switch between without leaving the page. They are Status: Draft and are backed by Mantine’s Tabs primitive. Clementine exports all four sub-components from @clementine-ds/ui with the Clementine theme applied.
When to use
- You have two or more sibling views of related content that share the same page region (e.g., Overview / Activity / Settings within a details panel).
- The content in each view is conceptually parallel — all tabs are peers, not steps.
- You want to keep all content accessible without navigating to a new route.
When not to use
- Top-level or site-wide navigation — use a sidebar or nav bar so users always know where they are in the overall app.
- Step-by-step workflows — use a
Stepperthat enforces order and shows progress. - Primary actions — use
Buttoncomponents; tabs select content, they don’t trigger actions. - Only one panel of content — a single tab adds visual noise without benefit.
Usage
ImportTabs, TabsList, TabsTab, and TabsPanel from @clementine-ds/ui. Compose them together: TabsList holds all TabsTab buttons; each TabsPanel is paired with a TabsTab via matching value strings.
Uncontrolled
Controlled
With a disabled tab
Setdisabled on any TabsTab to make it non-interactive. Disabled tabs are skipped during arrow-key navigation.
Vertical orientation
Props
Tabs
TabsProps extends Mantine’s TabsProps.
TabsList
TabsListProps extends Mantine’s TabsListProps.
TabsTab
TabsTabProps extends Mantine’s TabsTabProps.
TabsPanel
TabsPanelProps extends Mantine’s TabsPanelProps.
Interaction states
Keyboard interactions
Set
activateTabWithKeyboard={false} on Tabs if you want arrow keys to move focus without activating tabs automatically (useful when panels contain async-loaded content).
Accessibility
TabsListrendersrole="tablist". EachTabsTabrendersrole="tab". EachTabsPanelrendersrole="tabpanel".aria-selectedis set to"true"on the active tab and"false"on all others.aria-controlson eachTabsTabpoints to its associatedTabsPanelid.aria-labelledbyon eachTabsPanelpoints back to itsTabsTab.- Add
aria-labeltoTabsListto give the group of tabs an accessible name that screen readers announce when focus first enters the list. - If you use icon-only tabs with no visible text, add
aria-labelto eachTabsTabso screen readers can announce the tab’s purpose.