Developer Reference

WAI-ARIA Roles & Attributes

Make your web apps accessible. List of landmark roles, widget roles, and aria-attributes.

WAI-ARIA (Web Accessibility Initiative - Accessible Rich Internet Applications) defines a way to make Web content and Web applications more accessible to people with disabilities.

Widget

Element functions as a button
button
Checkable input
checkbox
Checkbox that represents on/off state
switch
Progress bar
progressbar

Window

A dialog window
dialog

Live Region

Important message (polite)
alert

Landmark

Navigational links
navigation
Main content of document
main
Search functionality
search

Structure

Container for tabs
tablist
Image container
img
Remove semantic meaning (purely visual)
presentation

Attribute

State: Item is expanded (true/false)
aria-expanded
State: Hidden from screen readers
aria-hidden
Label: Invisible label for accessibility
aria-label
State: Field has error
aria-invalid

Use these roles to define the structure of your application to screen readers, improving the experience for visually impaired users.