Accessibility in Blazor Accordion Component
6 Aug 20265 minutes to read
The Blazor Accordion component has been designed keeping in mind the WAI-ARIA specifications, by applying the appropriate WAI-ARIA roles, states, and properties along with keyboard support. This makes it usable for people who rely on assistive technologies, with information about the elements exposed through attributes like aria-labelledby. It helps to provide information about the elements in a document for assistive technology. The component implements keyboard navigation by following the WAI-ARIA practices and is tested in major screen readers, including NVDA 2023+, JAWS 2024+, VoiceOver (macOS/iOS), and TalkBack (Android).
The Blazor Accordion component follows accessibility guidelines and standards, including ADA, Section 508, WCAG 2.2 standards, and WCAG roles that are commonly used to evaluate accessibility.
The accessibility compliance for the Blazor Accordion component is outlined below.
| Accessibility Criteria | Compatibility |
|---|---|
| WCAG 2.2 Support | AA |
| Section 508 Support |  |
| Screen Reader Support | |
| Right-To-Left Support | |
| Color Contrast | |
| Mobile Device Support | |
| Keyboard Navigation Support | |
| Axe-core Accessibility Validation | |
- All features of the component meet the requirement.
- Some features of the component do not meet the requirement.
- The component does not meet the requirement.WAI-ARIA attributes
| Attributes | Purpose |
|---|---|
| role |
Button: Attribute is set to the Accordion header elements to indicate that the element can be used to toggle the visibility of the associated content section, describing the actual role of the element. Region: Attribute is set to the Accordion panel elements to create a landmark region that contains the currently expanded Accordion panel, describing the actual role of the element. |
| aria-labelledby | Attribute is set to content (panel) and it points to the corresponding Accordion header. |
| aria-controls | Attribute is set to the header and it points to the corresponding Accordion content. |
| aria-expanded | Attribute is set to the Accordion header elements to indicate the expand state of the Accordion item. Default value of this attribute is false. If an item is expanded, the attribute value changes to true. |
| aria-hidden | Attribute is set to the Accordion panel elements to indicate the visibility of the Accordion item content. Default value of this attribute is true. If an item content is visible, the attribute value changes to false. |
| aria-disabled | Set on the Accordion header (button) to indicate that the corresponding item is disabled, preventing toggle interaction. |
Keyboard interaction
Keyboard navigation is enabled by default. The possible keys are:
| Windows | Mac | Description |
|---|---|---|
| Space / Enter | Space / Enter | When the focus is on the Accordion header, activating the focused element expands or collapses the corresponding panel. |
| ↓ | ↓ | Focus the next Accordion header. |
| ↑ | ↑ | Focus the previous Accordion header. |
| Home | Home | Focus the first Accordion header. |
| End | End | Focus the last Accordion header. |
| Tab | Tab | Move focus into the Accordion header group from the preceding element, or out of the group to the next focusable element. |
| Shift + Tab | Shift + Tab | Move focus backward out of the Accordion header group. |
When a panel is expanded, focus remains on its header. Use the arrow keys to navigate between headers rather than moving into panel content.
Ensuring accessibility
The Blazor Accordion component’s accessibility levels are ensured through an axe-core software tool during automated testing.
The accessibility compliance of the Accordion component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the Accordion component with accessibility tools.