Don't forget the Chrome Dev Summit, starting Monday at 10:00am (Pacific) and streaming live on YouTube. Schedule.

Elements With ARIA Roles Have The Required aria-* Attributes

Why the audit is important

The role attribute helps screen readers understand the purpose of an ARIA widget. A role may have a set of required, additional attributes that describe the state of the widget to the screen reader.

See Introduction to ARIA for more information.

How to pass the audit

Below the audit, Lighthouse displays something like 1 element fails this test. The number varies depending on how many elements are failing. Click this label to expand the list. You can find each element in your DOM by running the $(), $$(), and $x() functions from the Chrome DevTools Console.

To find each element's missing required attributes:

  1. Note the role and aria-* attributes of the element.

  2. Go to Definition of Roles.

  3. Go to the page for this element's role.

  4. Check the aria-* attributes of the element against the Required States and Properties list.

  5. Add any attributes that are missing.

How the audit is implemented

This section explains how this audit is implemented, so that you can understand how the audit's score is calculated.

This audit is powered by the aXe Accessibility Engine. See Required ARIA attributes must be provided for more information.