Back to Learn
Pulseaccessibility

Roles Have All Required ARIA Attributes

What This Audit Checks

This audit verifies that every element with an ARIA role includes all attributes required by the WAI-ARIA specification for that role. For example, role="checkbox" requires aria-checked.

Why It Matters

Missing required attributes mean assistive technologies cannot fully communicate the element's state. A checkbox without aria-checked leaves screen reader users unable to determine whether it is selected.

How to Fix It

  • Look up the role's required attributes in the WAI-ARIA spec and add any that are missing.
  • Maintain state attributes dynamically. Required attributes like aria-checked or aria-expanded must update as users interact with the element.
  • Prefer native HTML elements that handle state automatically. A <input type="checkbox"> manages checked state without any ARIA.
<!-- Bad: role="slider" requires aria-valuenow -->
<div role="slider" aria-valuemin="0" aria-valuemax="100"></div>

<!-- Good: all required attributes present -->
<div role="slider" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100"></div>

How Pulse Tracks This

Pulse flags this audit in your Lighthouse accessibility score. When the audit fails, Pulse shows which elements triggered it so you can fix them directly.

Resources