A disclosure pattern made of headers that expand or collapse content. Must be keyboard operable with correct ARIA roles and states.
Accordions are UI components that allow users to expand and collapse content sections, commonly used for FAQs, navigation menus, and content organization. While they help manage information density, accordions present unique accessibility challenges that must be carefully addressed.
The key accessibility requirements for accordions include proper ARIA attributes (`aria-expanded`, `aria-controls`), keyboard navigation support, and clear visual indicators of expand/collapse state. Screen reader users need to understand when content is available, when it's expanded, and how to control it.
Poorly implemented accordions can trap users, hide important information, or create navigation confusion. Well-implemented accordions provide clear affordances, consistent behavior, and multiple ways to access content.
Creating accessible accordions requires attention to several technical details:
ARIA Implementation: Use `aria-expanded="true/false"` on trigger buttons to indicate state, `aria-controls` to link triggers to their content panels, and `aria-labelledby` to associate labels with controls.
Keyboard Support: Ensure all accordion triggers are keyboard accessible. Users should be able to tab to triggers and activate them with Enter or Space. Consider implementing arrow key navigation between accordion items.
Focus Management: When accordions open or close, focus should be managed appropriately. Some implementations move focus to the newly opened content, others keep focus on the trigger.
Visual Indicators: Provide clear visual cues for expand/collapse state. Common patterns include rotating arrows, plus/minus icons, or changing button text.
Content Structure: Ensure accordion content is properly structured with headings and landmarks so screen readers can navigate within expanded sections.
Responsive Behavior: On mobile devices, consider whether accordions should auto-expand or maintain collapsed state for better usability.
Join over 1 million websites using WebAbility to ensure digital accessibility compliance and provide equal access to all users.
A rotating banner of content. Often problematic for accessibility: ensure keyboard control, visible focus, pause/stop, and proper semantics.
An overlay that requires user interaction before returning to the main UI. Must trap focus, label the dialog, and provide accessible dismissal.
A pattern to show or hide additional content, typically via a button that toggles aria-expanded and controls a region.
Input widget combining text field with popup list. Requires complex ARIA states and keyboard navigation patterns.
ARIA role for interactive tabular data where cells are focusable and may be editable, requiring 2D navigation.
This glossary is continuously improved and maintained by WebAbility to advance accessible design and development.Contact us to suggest improvements or report issues.