Components · Navigation & Layout

Accordion

Stacked sections that open and close, so people can skip what they don't need.

Automated a11y scan passing Element: <h3> + <button aria-expanded>

Component Workbench

Switch between the live interactive preview, syntax-highlighted implementation code, copyable AI coding agent prompt, and designer anatomy blueprint.

Accordion · Canonical Spec

Pods are drained gracefully with health probe verification before terminating existing replicas.

When to use it

Do

  • Use it for optional detail, such as FAQs.
  • Write titles that tell people what's inside.

Don't

  • Hide information everyone needs to read.
  • Nest an accordion inside another accordion.

Accessibility & Keyboard Interaction

Requirements for using this component accessibly, following the W3C ARIA Authoring Practices Guide.

Interaction / KeyBehavior & Compliance Requirement
Heading HierarchyTrigger button is wrapped in semantic <h3>/<h4>.
Arrow Up / DownMoves focus cyclically between accordion triggers.

Tokens

Values update with the current theme.

RoleTokenCurrent value
Container Radius--as-radius-lg
Divider Rule--as-semantic-color-border-subtle
Esc
↑↓ navigateEnter openEsc close