Skip to main content
← All Demos

Tabs

Tabs organize related content into separate panels and let users switch sections quickly.

1. Automatic Activation (Default)

Tabs activate on focus. Arrow keys move focus AND activate the tab simultaneously.

Account Settings

Manage your account details, display name, and avatar.

Keyboard: Tab to tablist → ← → to navigate & activate → Tab to panel content
<Tabs.Root defaultValue='auto-1'>
  <Tabs.List>
    <Tabs.Trigger value='auto-1'>Account</Tabs.Trigger>
    <Tabs.Trigger value='auto-2'>Password</Tabs.Trigger>
  </Tabs.List>
  <Tabs.Content value='auto-1'>Account settings</Tabs.Content>
</Tabs.Root>

2. Manual Activation

Arrow keys move focus but do NOT activate. Press Enter or Space to activate the focused tab. Useful when tab content is expensive to load.

Overview panel. Arrow to other tabs — they won't activate until Enter/Space.

Keyboard: ← → to move focus → Enter/Space to activate the focused tab
<Tabs.Root activationMode='manual' defaultValue='man-1'>
  <Tabs.List>
    <Tabs.Trigger value='man-1'>Overview</Tabs.Trigger>
    <Tabs.Trigger value='man-2'>Analytics</Tabs.Trigger>
  </Tabs.List>
  <Tabs.Content value='man-1'>Overview panel</Tabs.Content>
</Tabs.Root>

3. Vertical Orientation

With orientation="vertical", Arrow Up/Down navigate tabs instead of Left/Right.

General settings panel. Use ↑ ↓ to navigate tabs.

Keyboard: ↑ ↓ to navigate (not ← →)
<Tabs.Root orientation='vertical' defaultValue='vert-1'>
  <Tabs.List>
    <Tabs.Trigger value='vert-1'>General</Tabs.Trigger>
    <Tabs.Trigger value='vert-2'>Privacy</Tabs.Trigger>
  </Tabs.List>
  <Tabs.Content value='vert-1'>General settings</Tabs.Content>
</Tabs.Root>

4. Controlled Tabs

Parent controls which tab is active. External buttons can switch tabs programmatically.

First tab panel (controlled).

const [value, setValue] = useState('tab-1');

<Tabs.Root value={value} onValueChange={(nextValue) => setValue(nextValue)}>
  <Tabs.List>
    <Tabs.Trigger value='tab-1'>Tab 1</Tabs.Trigger>
    <Tabs.Trigger value='tab-2'>Tab 2</Tabs.Trigger>
  </Tabs.List>
  <Tabs.Content value='tab-1'>First tab panel</Tabs.Content>
</Tabs.Root>

5. Disabled Tabs

Individual tabs can be disabled. Arrow key navigation skips disabled tabs.

First tab. Arrow Right should skip the disabled tab.

Expected: Arrow keys skip disabled tabs. Tab does not stop on disabled triggers.
<Tabs.Root defaultValue='dis-1'>
  <Tabs.List>
    <Tabs.Trigger value='dis-1'>Active</Tabs.Trigger>
    <Tabs.Trigger value='dis-2' disabled>Disabled</Tabs.Trigger>
    <Tabs.Trigger value='dis-3'>Active</Tabs.Trigger>
  </Tabs.List>
  <Tabs.Content value='dis-1'>First tab.</Tabs.Content>
</Tabs.Root>

6. Render Props Pattern

Use render props to access isSelected, isFocused and states for custom rendering.

Home content. Trigger shows selected/focused indicators.

<Tabs.Root defaultValue='rp-1'>
  <Tabs.List>
    <Tabs.Trigger value='rp-1'>
      {({ isSelected }) => (isSelected ? '● Home' : '○ Home')}
    </Tabs.Trigger>
  </Tabs.List>
  <Tabs.Content value='rp-1'>Home content</Tabs.Content>
</Tabs.Root>
← All Demos