ARIA role attribute misuse

Compliance Data & User Impact

User Impact: Critical

100% Complete

Disabilities Affected:

  • blindness
  • deafblindness

WCAG Version:

WCAG Levels:

  • A

WCAG Guidelines:

Solution Techniques:

Automated Test Accuracy:

Check1st Severity:

DRRSAG Designations:

  • role

How to Fix the Problem

Use the role attribute only on relevant elements and according to the WAI-ARIA roles specification. The WAI-ARIA specification provides an informative description of each role.

The Algorithm, in Simple Terms

The engine scans all elements using a role attribute representing clickable elements and looks for one of the following events on the element: keydown, keyup, keypress, click, dblclick, focusin, mousedown and mouseup

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

<a href="" role="link">user1st website</a>

Additional Information


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.

Address: 401 9th St NW, 6th Floor
Washington, DC 20004
Phone number: (888) 995-WCAG
International number: 1(888) 995-9224