Dropdown
The dropdown React Carbon component has been tested against the latest W3C Web Content Accessibility Guidelines (WCAG) 2.1 Level A and AA success criteria and violations have been identified as high priority issues. This document will be updated when these accessibility issues are resolved.
Accessibility considerations
- Avoid very long option names to facilitate understandability and perceivability.
- Do not use the same word or phrase at the beginning of a set of options.
- Avoid options that contain headings and interactive elements such as links, buttons, or checkboxes.
- If the dropdown is a required field include the aria-required property and indicate that it is a required field and use the validation message for input errors.
Resources
- W3C WAI-ARIA Authoring Practices Listbox Design Pattern covers the usage of ARIA names, state and roles, as well as the expected keyboard interactions.
- IBM Accessibility Requirements:
- 2.4.7 Focus Visible (WCAG Success Criteria 2.4.7)
- 3.2.2 On Input (WCAG Success Criteria 3.2.2)
- 4.1.2 Name, Role, Value (WCAG Success Criteria 4.1.2)
Accessibility testing
Automated, manual and screen reader accessibility verification test has been performed on the dropdown React Carbon Component. WCAG 2.1 Level A and AA success criteria issues have been identified and the list of open accessibility violations is available in the Carbon Component GitHub repository.
Automated test
Automated test environmentResults
- macOS Mojave version 10.14.2 with VoiceOver
- Chrome version 77.0.3865.90
- Dynamic Assessment Plugin (DAP) version 1.8.0.0 - IBM Accessibility WCAG 2.1 Sept. 2019 Ruleset
- Carbon React version 7.7.1
- Chrome version 77.0.3865.90
- Dynamic Assessment Plugin (DAP) version 1.8.0.0 - IBM Accessibility WCAG 2.1 Sept. 2019 Ruleset
- Carbon React version 7.7.1
DAP test:
- Violations
- Violations