Home > Criteria > Wrong ARIA role attribute's value

Wrong ARIA role attribute's value

Compliance Data & User Impact

User Impact: Critical

Disabilities Affected:

blindness
deafblindness

WCAG Version:
2

WCAG Levels:

WCAG Guidelines:

4.1.2

Solution Techniques:

ARIA4.Incorrect

Automated Test Accuracy:
Medium

uTester Severity:
Error

DRRSAG Designations:

role

How to Fix the Problem

Use the role attribute with one of the non-abstract values defined in the WAI-ARIA roles specification. The WAI-ARIA specification provides an informative description of each role, how it relates to other roles, and the states and properties for each role.

The Algorithm, in Simple Terms

The engine scans all element using role attribute for correct value according to WAI-Aria specification

Why Is it Important?

users who use assistive tools, such as screen readers will fail to understand properly the role of the element

Code Example

role="button" instead of role="btn"

Additional Information

https://www.w3.org/TR/aria-in-html/

Example

Access Example

Ignore this issue if this element is part of a list of similar elements or a container of a list such as: select, autocomplete field widget, the table inside a date picker widget, a tab in a tab control widget).

This element perfoms as a container, and has no functionality. This container may contain another elements that has functionality or logical role.

Ignore this issue if this element has an alternative that performs the same and overrides the content of this element.