Elements must only use allowed ARIA attributes

Log in (Premium content) Request a demo

Rule Description

Not all ARIA role-attribute combinations are valid. This Rule checks that each role is supplied with allowed attributes.

The Algorithm, in Simple Terms

Checks that each element with an ARIA role uses only ARIA attributes allowed for that role.

Why this is Important

Using ARIA attributes in roles where they are not allowed can interfere with the accessibility of the web page. Using an invalid role-attribute combination will, at best, result in no effect on the accessibility of the application and, at worst, may trigger behavior that disables accessibility for entire portions of an application.

How to Fix the Problem

WAI-ARIA explicitly defines which attributes are allowed for any given role and for every attribute, where that attribute may be used. The detailed information on each attribute can be found by looking at the documentation for each role and/or each attribute.

Compliance Data & User Impact

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

Related Deque University Course Pages

Related Deque Code Library Examples

Other Related Resources

Additional Information

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