ARIA attributes must conform to valid names

Log in (Premium content) Request a demo

Rule Description

ARIA attributes (i.e. starting with aria-) must have valid names. Referring to a misspelled attribute or to one that does not exist will result in an invalid attribute and thus failure of this Rule.

The Algorithm, in Simple Terms

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

Why this is Important

If the developer uses a non-existent or misspelled ARIA attribute, the attribute will not be able to perform the accessibility function intended by the developer.

How to Fix the Problem

This rule checks for the presence of an unrecognized ARIA attribute, which prevents the attribute from functioning as intended.

Ensure all ARIA attributes (as opposed to the values inside of them) used are spelled correctly and correspond to valid ARIA attribute names.

For example, aria-hidden="true" would pass, while aria-visible="rute" would fail.

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
Section 508 Guidelines:
  • Not applicable

Related Deque University Course Pages

Other Related Resources

Additional Information

Relevant Technologies:
  • HTML 4
  • HTML5
  • ARIA
Test Reliability: Automated testing is possible, with high accuracy
Rule ID: aria-valid-attr