ARIA attributes must conform to valid values

Log in (Premium content) Request a demo

Rule Description

ARIA attributes (i.e. starting with aria-) must contain valid values. These values must be spelled correctly and correspond to values that make sense for a particular attribute in order to perform the intended accessibility function.

The Algorithm, in Simple Terms

Checks all elements that contain WAI-ARIA atributes to ensure that the values of the attributes are valid

Why this is Important

If the developer uses an incorrect value for an ARIA attribute, the attribute will not be able to perform the accessibility function intended by the developer.

How to Fix the Problem

Ensure the value inside each attribute is spelled correctly and corresponds to a valid value.

For example, aria-hidden="true" would pass, but aria-hidden="rtue" would fail, as would aria-hidden="pizza".

Compliance Data & User Impact

User Impact: Critical
Disabilities Affected:
  • Blindness
  • Deafblindness
  • Mobility/Dexterity
Issue Type:
  • WCAG 2.0 (A): MUST
  • WCAG 2.1 (A): MUST
WCAG Success Criteria:
  • 4.1.1 Parsing
  • 1.3.1 Info and Relationships
  • 4.1.2 Name, Role, Value
Section 508 Guidelines:
  • Not applicable

Related Deque University Course Pages

Other Related Resources

Additional Information

Relevant Technologies:
  • HTML 4
  • HTML5
  • ARIA
  • JavaScript
Relevant Custom Widget Type(s):
  • Live Region (ARIA)
Test Reliability: Automated testing is possible, with high accuracy
Rule ID: aria-valid-attr-value