Ensures Elements Do Not Use Deprecated Roles

Yotam Flohr
Researcher
Blind Low vision Hearing Mobility
WCAG 2.1 Level A

Written and researched for humans by humans

Yotam Flohr
Researcher
Ritvik Shrivastava
Expertly reviewed by
Comments: 0
Your entire domain
Get detailed instructions on how to resolve every accessibility issue on your website

Any elements that contain WAI-ARIA role attributes should not have roles that are deprecated in the latest version of the WAI-ARIA specification.

Why It Matters

Deprecated WAI-ARIA roles can create accessibility issues because they won’t be correctly processed by assistive technologies such as screen readers. This prevents all users from having access to important information. 

Fixing the Issue

Developers need to make sure that all values assigned to role=”” correspond to WAI-ARIA roles that are not deprecated. Roles shouldn’t be abstract either. 

In the case of a directory, consider using section, list, or tree instead, depending on how the directory was used.

Test Cases

For more examples, visit W3C’s GitHub’s ATC Rules library