aria-valid-attr
Ensures attributes that begin with aria-
are valid ARIA attributes.
Description
Valid names are required for ARIA properties that begin with aria-
. A reference to an invalid attribute or an attribute that doesn’t exist will result in a violation of this regulation.
Why is it important?
When an element with an invalid ARIA attribute name is encountered, an assistive technology may disregard the element or react to it unexpectedly. As a consequence, individuals who use assistive technologies may find it challenging or impossible to use the element.
Insufficient use of the WAI-ARIA 1.1 W3C Recommendation’s attributes prevents developers from correctly communicating user interface behaviors and structural information to assistive technologies in document-level markup.
Examples
-
Success:
- The toggle button has a valid ARIA attribute name.
-
Failure:
- The toggle button has an invalid ARIA attribute name.
How to fix?
Provide a valid name for each ARIA attribute:
- Ensure the correct attribute name is used.
- Ensure the attribute name is spelled correctly.
Tags
cat.aria, wcag2a, wcag412
References
- WCAG 4.1.2: Name, Role, Value
- Deque University: aria-valid-attr
- Accessibility Insights: aria-valid-attr
- Evinced Digital Accessibility Knowledge Base: aria-valid-attr
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!