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