Skip to main content
← All Demos

Accordion

Accordion organizes related content into expandable sections, helping keep long interfaces structured and scannable.

1. Single Expand Mode

Only one panel open at a time. Arrow Up/Down navigate between triggers. Enter/Space toggles the focused panel.

Keyboard: Tab to first trigger → ↑↓ to navigate → Enter/Space to toggle → Home/End for first/last
<Accordion.Root defaultValue='item-1'>
  <Accordion.Item value='item-1'>
    <Accordion.Header>
      <Accordion.Trigger>Tab 1</Accordion.Trigger>
    </Accordion.Header>
    <Accordion.Content>...</Accordion.Content>
  </Accordion.Item>
</Accordion.Root>

2. Multiple Expand Mode

Multiple panels can be open simultaneously with multiple.

<Accordion.Root multiple defaultValue='item-1'>
  <Accordion.Item value='item-1'>
    <Accordion.Header>
      <Accordion.Trigger>Tab 1</Accordion.Trigger>
    </Accordion.Header>
    <Accordion.Content>...</Accordion.Content>
  </Accordion.Item>
</Accordion.Root>

3. Collapsible Single Mode

With collapsible (default true), all panels can be closed in single mode. Set collapsible={false} to keep one panel always open.

<Accordion.Root collapsible>
  <Accordion.Item value='panel-a'>
    <Accordion.Header>
      <Accordion.Trigger>Panel A</Accordion.Trigger>
    </Accordion.Header>
    <Accordion.Content>...</Accordion.Content>
  </Accordion.Item>
</Accordion.Root>

4. Controlled Accordion

Parent manages which panel is open. External buttons can open specific panels.

Content for the first panel. Controlled by parent state.

const [value, setValue] = useState<string | string[]>('item-1');

<Accordion.Root value={value} onValueChange={(v)=>setValue(v)}>
  <Accordion.Item value='item-1'>
    <Accordion.Header>
      <Accordion.Trigger>First Panel</Accordion.Trigger>
    </Accordion.Header>
    <Accordion.Content>...</Accordion.Content>
  </Accordion.Item>
</Accordion.Root>

5. Disabled Items

Individual items can be disabled. Keyboard navigation skips disabled triggers.

Expected: Arrow keys skip the disabled item.
<Accordion.Root>
  <Accordion.Item value='d-2' disabled>
    <Accordion.Header>
      <Accordion.Trigger>Disabled item</Accordion.Trigger>
    </Accordion.Header>
    <Accordion.Content>...</Accordion.Content>
  </Accordion.Item>
</Accordion.Root>

6. Horizontal Orientation

With orientation="horizontal", arrow Left/Right navigate instead of Up/Down.

Keyboard: ← → to navigate (not ↑ ↓)
<Accordion.Root orientation='horizontal'>
  <Accordion.Item value='h-1'>
    <Accordion.Header>
      <Accordion.Trigger>Tab 1</Accordion.Trigger>
    </Accordion.Header>
    <Accordion.Content>...</Accordion.Content>
  </Accordion.Item>
</Accordion.Root>

7. Fully Disabled Accordion

All items disabled via root disabled prop.

<Accordion.Root disabled>
  <Accordion.Item value='a'>
    <Accordion.Header>
      <Accordion.Trigger>Item A</Accordion.Trigger>
    </Accordion.Header>
    <Accordion.Content>...</Accordion.Content>
  </Accordion.Item>
</Accordion.Root>
← All Demos