← Components/primitives

Disclosure

Carbon's Disclosure, a single collapsible section with a chevron trigger. Sits below Accordion in scope: Accordion is a multi-section pattern with managed open-state across siblings; Disclosure is one standalone section that toggles independently.

primitivesstablea11y: untested2/3 coverageEdit on GitHub ↗
primitives-disclosure--defaultOpen all variants →

When to use

  • A standalone "show more" / "show details" surface, separate from any sibling sections.
  • Optional advanced settings that should be hidden by default to keep the surface dense.
  • Marketing FAQ items that don't share open-state with each other.
  • Inline progressive disclosure inside a form group.

When not to use

  • Multiple linked collapsible sections sharing a managed open-state → use `Accordion`. Disclosure doesn't coordinate siblings.
  • A panel that should always be visible → don't wrap it.
  • A modal-style reveal with a dim overlay → use `Sheet` or `Dialog`.