Button disabled state is not conveyed
The disabled state of a button is not conveyed to screen reader users
- Rule ID:
- button-state-disabled
- User Impact:
- Serious
- WCAG :
- 4.1.2.a
Rule
The state of user interface components must be programmatically determinable by assistive technologies.
Background
When a button is disabled, that information must be conveyed programmatically for screen reader and other assistive technology users. If the disabled state is not conveyed, the user may be confused as to why the button is not responding to their interaction.
How to Fix
If the button is a native HTML <button>
element, you must add the disabled
attribute to the element.
If the button is a custom element, you must add the aria-disabled="true"
attribute to the element.