Skip to main content
The 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 Stepper that enforces order and shows progress.
  • Primary actions — use Button components; tabs select content, they don’t trigger actions.
  • Only one panel of content — a single tab adds visual noise without benefit.

Usage

Import Tabs, 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

Set disabled 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

  • TabsList renders role="tablist". Each TabsTab renders role="tab". Each TabsPanel renders role="tabpanel".
  • aria-selected is set to "true" on the active tab and "false" on all others.
  • aria-controls on each TabsTab points to its associated TabsPanel id. aria-labelledby on each TabsPanel points back to its TabsTab.
  • Add aria-label to TabsList to 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-label to each TabsTab so screen readers can announce the tab’s purpose.

Draft status. The Tabs components are currently Draft. Arrow-key navigation between tabs needs verification in your target browsers before shipping to production.