Accessibility in Vue Accordion component
26 Jan 20245 minutes to read
The Accordion component has been designed keeping in mind the WAI-ARIA specifications, by applying the prompt WAI-ARIA roles, states, and properties along with the keyboard support. Thus, making it usable for people who use assistive WAI-ARIA Accessibility supports that is achieved through the attributes like aria-labelledby. It helps to provides information about the elements in a document for assistive technology. The component implements the keyboard navigation support by following the WAI-ARIA practices and tested in major screen readers.
The accessibility compliance for the Accordion component is outlined below.
| Accessibility Criteria | Compatibility |
|---|---|
| WCAG 2.2 Support |  |
| Section 508 Support | |
| Screen Reader Support | |
| Right-To-Left Support | |
| Color Contrast | |
| Mobile Device Support | |
| Keyboard Navigation Support | |
| Accessibility Checker Validation | |
| 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.ARIA attributes
| Roles and Attributes | Functionalities |
|---|---|
| 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. <br/ |
| 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 indicates 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-selected | Attribute set to the Tab items to indicates the selection state for Tab items. Active Tab is set to true for this attribute. |
| aria-hidden | Attribute is set to the Accordion panel elements to indicates the content visible state of the Accordion Item. Default value of this attribute is true. If an item content is visible, the attribute value changes to false. |
| aria-disabled | It indicates the disabled state of the Accordion and its items. |
Keyboard interaction
Keyboard navigation is enabled by default. Possible keys are:
| Key | Description |
|---|---|
| Space or Enter | When focus is on the Accordion header, click on the focused element makes the element to expand and collapse. |
| Down Arrow | Focus the next Accordion header. |
| Up Arrow | Focus the previous Accordion header. |
| Home | Focus the first Accordion header. |
| End | Focus the last Accordion header. |
| Tab | To Move focus through the interactive elements. |
| Shift + Tab | To Move focus through the interactive elements. |
Ensuring accessibility
The Accordion component’s accessibility levels are ensured through an accessibility-checker and axe-core software tools 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.