Components / navigation

State matrix

expandedrequired
collapsedrequired

Anatomy

  • disclosure list
  • summary buttons
  • content regions

Keyboard contract

Enter or Space toggles the focused summary using native details behavior.

Screen-reader contract

Each summary exposes expanded state and precedes its associated content.

Content rules

  • Summaries state what is revealed.
  • Do not nest primary navigation in accordions.

Public API

PropTyperequiredDescription
itemsAccordionItem[]requiredDisclosure sections

Adaptation contracts

RTL
Follow document direction for directional keys and visuals while preserving semantic order.
High contrast
Current, selected, expanded, and focus states remain distinct without fill alone.
Reduced motion
Move selection and disclosure state without animated travel.

Verification IDs

Accordion/native-details

Live

Live

Details
Hidden until expanded

Copyable example

import { Accordion } from "@awesome-ds/react";

<Accordion items={[{id:'1',title:'Q',content:'A'}]} />