Accordion — Accessibility Specification

WCAG 2.1 AA • AODA compliant • Updated 2025-10-28


What is this component?

What is this component? Accordions show/hide sections of content. Buttons control disclosure of associated panels.

Accessibility Requirements

RequirementWCAG CriteriaDescription
Keyboard2.1.1Tab to headers; Space/Enter toggles; optional arrow navigation between headers.
State4.1.2Use aria-expanded on header buttons; panels reference headers.
Focus Visible2.4.7Provide visible focus on headers.

ARIA Roles and Attributes

ARIA Role/AttributeUsed OnPurpose & Usage
button[aria-expanded]Accordion headersControls visibility of panel.
aria-controls / aria-labelledbyHeader/PanelBind header to panel and vice versa.

Implementation Guidelines


DO’s

Don’ts

Common Pitfalls

Testing Checklist

Test ItemWCAG CriteriaPass Criteria
State sync4.1.2AT hears expanded/collapsed correctly.
Keyboard2.1.1Space/Enter toggles; focus remains controlled.