ARIA Role Reference

Summary

The ARIA Role Reference provides a searchable, at-a-glance guide to every WAI-ARIA role defined in the ARIA 1.2 specification. Each entry lists required properties, supported states and attributes, which HTML elements are appropriate hosts, and a ready-to-copy code snippet. Developers can quickly look up any role without leaving their editor workflow. The data is embedded client-side so lookups are instant with no server round-trips.

How it works

1. Type a role name or keyword into the search box to filter the role list.
2. Click any role card to expand its full detail panel.
3. Review required properties that must be present for the role to be valid.
4. Check supported attributes for optional states you can set.
5. Copy the provided code snippet directly into your HTML or component.

Use cases

• Look up which aria-* attributes are required for a custom combobox.
• Verify permitted HTML host elements before choosing a role.
• Find the correct role for a custom UI widget (slider, tree, grid, etc.).
• Review abstract roles to understand the ARIA inheritance hierarchy.
• Share a quick reference link with teammates reviewing a PR.
• Double-check role constraints while writing accessibility tests.

Frequently Asked Questions