Skip to main content
← All Demos

Collapsible

Collapsible toggles the visibility of a content area, useful for optional details and progressive disclosure patterns.

1. Basic Collapsible

Click or press Enter/Space to toggle. Screen readers announce expanded/collapsed state via aria-expanded.

Keyboard: Tab to trigger → Enter/Space to toggle → Tab into content when expanded
<Collapsible.Root>
  <Collapsible.Trigger>Show more info</Collapsible.Trigger>
  <Collapsible.Content>
    <p>Collapsible content</p>
  </Collapsible.Content>
</Collapsible.Root>

2. Default Open

Collapsible that starts expanded.

By setting defaultOpen, the collapsible starts in the expanded state.

<Collapsible.Root defaultOpen>
  <Collapsible.Trigger>This is already expanded</Collapsible.Trigger>
  <Collapsible.Content>
    <p>Starts open</p>
  </Collapsible.Content>
</Collapsible.Root>

3. Controlled Collapsible

Parent manages open state. External buttons can toggle programmatically.

const [open, setOpen] = useState(false);

<Collapsible.Root open={open} onOpenChange={(o)=>setOpen(o)}>
  <Collapsible.Trigger>Controlled section</Collapsible.Trigger>
  <Collapsible.Content>
    <p>This content is controlled by parent state.</p>
  </Collapsible.Content>
</Collapsible.Root>

4. Disabled Collapsible

Disabled collapsible trigger cannot be activated.

Content is visible but trigger cannot be toggled.

<Collapsible.Root disabled>
  <Collapsible.Trigger>Disabled (collapsed)</Collapsible.Trigger>
  <Collapsible.Content>
    <p>Should not be reachable.</p>
  </Collapsible.Content>
</Collapsible.Root>

<Collapsible.Root disabled defaultOpen>
  <Collapsible.Trigger>Disabled (expanded)</Collapsible.Trigger>
  <Collapsible.Content>
    <p>Content is visible but cannot be toggled.</p>
  </Collapsible.Content>
</Collapsible.Root>

5. Render Props Pattern

Trigger exposes isOpen, open, close, toggle for custom rendering.

<Collapsible.Root>
  <Collapsible.Trigger>
    {({ isOpen }) => (isOpen ? 'Collapse details' : 'Expand details')}
  </Collapsible.Trigger>
  <Collapsible.Content>
    <p>Content</p>
  </Collapsible.Content>
</Collapsible.Root>

6. Content with Interactive Elements

Collapsible content containing focusable elements. Tab order should include content elements when expanded.

Tab order: Trigger → (when expanded) Input → Save → Reset → next element
<Collapsible.Root>
  <Collapsible.Trigger>Advanced settings</Collapsible.Trigger>
  <Collapsible.Content>
    <input type='text' placeholder='Enter API key' />
    <button>Save</button>
    <button>Reset</button>
  </Collapsible.Content>
</Collapsible.Root>

7. Multiple Collapsibles (FAQ Pattern)

Multiple independent collapsible sections. Each manages its own state. Unlike Accordion, multiple can be open simultaneously.

<Collapsible.Root>
  <Collapsible.Trigger>What browsers are supported?</Collapsible.Trigger>
  <Collapsible.Content>
    <p>All modern browsers.</p>
  </Collapsible.Content>
</Collapsible.Root>

<Collapsible.Root>
  <Collapsible.Trigger>Is it free to use?</Collapsible.Trigger>
  <Collapsible.Content>
    <p>Yes, it is open source.</p>
  </Collapsible.Content>
</Collapsible.Root>
← All Demos