R.o.R
Buy me a coffee

ARIA Role Reference

Search and browse the full WAI-ARIA 1.2 role catalogue — descriptions, required attributes, owned elements, and HTML equivalents.

92 roles in WAI-ARIA 1.2

command
abstract

Abstract superclass for widgets that perform an action but do not receive input.

Supported attributes

aria-atomicaria-busyaria-controlsaria-currentaria-describedbyaria-detailsaria-disabledaria-dropeffectaria-flowtoaria-grabbedaria-haspopuparia-hiddenaria-keyshortcutsaria-labelaria-labelledbyaria-livearia-ownsaria-relevantaria-roledescription

Inherits from

widget
composite
abstract

Abstract superclass for widgets that contain navigable descendants or owned elements.

Supported attributes

aria-activedescendantaria-disabled

Inherits from

widget
input
abstract

Abstract superclass for widgets that allow user input.

Supported attributes

aria-disabled

Inherits from

widget
landmark
abstract

Abstract superclass for regions that are major navigation landmarks.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
range
abstract

Abstract superclass for input representing a range of values.

Supported attributes

aria-valuemaxaria-valueminaria-valuenowaria-valuetext

Inherits from

widget
roletype
abstract

The base role for all other roles — provides core properties all roles inherit.

Supported attributes

aria-atomicaria-busyaria-controlsaria-currentaria-describedbyaria-detailsaria-dropeffectaria-flowtoaria-grabbedaria-hiddenaria-keyshortcutsaria-labelaria-labelledbyaria-livearia-ownsaria-relevantaria-roledescription
section
abstract

Abstract superclass for document sections that are contained in other sections.

Supported attributes

aria-labelaria-labelledby

Inherits from

structure
sectionhead
abstract

Abstract superclass for elements that label or summarise a section.

Supported attributes

aria-labelaria-labelledby

Inherits from

structure
select
abstract

Abstract superclass for composites that support single or multiple selection.

Supported attributes

aria-orientation

Inherits from

compositeinput
structure
abstract

Abstract superclass for document structural elements.

Inherits from

roletype
widget
abstract

Abstract superclass for interactive user interface components.

Inherits from

roletype
window
abstract

Abstract superclass for browser or app windows.

Supported attributes

aria-modal

Inherits from

roletype
article<article>
document

A section of a page that could stand alone, e.g. a blog post or forum entry.

Supported attributes

aria-posinsetaria-setsize

Inherits from

documentsection
blockquote<blockquote>
document

Content quoted from another source.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
caption<caption>, <figcaption>
document

Visible label or explanatory text for a figure, table, or grid.

Required context (parent)

figuregridtabletreegrid

Inherits from

section
cell<td>
document

A cell in a tabular container.

Supported attributes

aria-colindexaria-colspanaria-rowindexaria-rowspan

Required context (parent)

row

Inherits from

section
code<code>
document

A fragment of computer code.

Inherits from

section
columnheader<th scope="col">
document

A header cell in a column that provides a label for the column.

Supported attributes

aria-colindexaria-colspanaria-expandedaria-readonlyaria-requiredaria-rowindexaria-rowspanaria-selectedaria-sort

Required context (parent)

row

Inherits from

cellgridcellsectionhead
definition<dd>
document

A definition of a term or concept.

Supported attributes

aria-labelledby

Inherits from

section
deletion<del>
document

Content that has been removed from the document.

Inherits from

section
document<html>, <body>
document

An element containing content that assistive technology users may want to navigate in reading mode.

Supported attributes

aria-expanded

Inherits from

structure
emphasis<em>
document

Inline text with stress emphasis.

Inherits from

section
figure<figure>
document

A perceivable section of content, usually with a caption.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
generic<div>, <span>
document

A nameless container element with no semantic meaning, equivalent to a plain div.

Inherits from

structure
grid<table> (interactive)
document

A composite widget with rows and columns, like a spreadsheet or data table with interactive cells.

Supported attributes

aria-colcountaria-levelaria-multiselectablearia-readonlyaria-rowcount

Required owned elements

rowrowgroup

Inherits from

compositetable
gridcell<td> (in interactive grid)
document

A cell in a grid or treegrid.

Supported attributes

aria-colindexaria-colspanaria-expandedaria-readonlyaria-requiredaria-rowindexaria-rowspanaria-selected

Required context (parent)

row

Inherits from

cellwidget
group<fieldset>, <details>, <optgroup>
document

A set of user interface objects that are not intended to be included in a page table of contents.

Supported attributes

aria-activedescendantaria-disabledaria-labelaria-labelledby

Inherits from

section
heading<h1>–<h6>
document

A heading for a section of the page, indicating hierarchy.

Required attributes

aria-level

Supported attributes

aria-expanded

Inherits from

sectionhead
img<img>
document

A container for a collection of elements that form an image.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
insertion<ins>
document

Content that has been added to the document.

Inherits from

section
list<ul>, <ol>
document

A section containing listitem elements.

Supported attributes

aria-labelaria-labelledby

Required owned elements

listitem

Inherits from

section
listitem<li>
document

A single item in a list.

Supported attributes

aria-levelaria-posinsetaria-setsize

Required context (parent)

list

Inherits from

section
mark<mark>
document

Text that is marked or highlighted for reference.

Inherits from

section
math<math>
document

Content that represents a mathematical expression.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
meter<meter>
document

A scalar measurement within a known range, e.g. disk usage.

Required attributes

aria-valuenow

Supported attributes

aria-valuemaxaria-valueminaria-valuetext

Inherits from

range
none
document

An element whose implicit ARIA semantics are exposed to the accessibility API as nothing (synonym for "presentation").

Inherits from

structure
note
document

A section whose content is parenthetical or ancillary to the main content.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
paragraph<p>
document

A paragraph of content.

Inherits from

section
presentation
document

An element whose implicit ARIA semantics are removed and will not be mapped to the accessibility tree.

Inherits from

structure
row<tr>
document

A row of cells in a tabular container.

Supported attributes

aria-colindexaria-expandedaria-levelaria-posinsetaria-rowindexaria-selectedaria-setsize

Required owned elements

cellcolumnheadergridcellrowheader

Required context (parent)

gridrowgrouptabletreegrid

Inherits from

groupwidget
rowgroup<tbody>, <thead>, <tfoot>
document

A group of rows in a tabular container.

Required owned elements

row

Required context (parent)

gridtabletreegrid

Inherits from

structure
rowheader<th scope="row">
document

A header cell in a row that provides a label for the row.

Supported attributes

aria-colindexaria-colspanaria-expandedaria-readonlyaria-requiredaria-rowindexaria-rowspanaria-selectedaria-sort

Required context (parent)

row

Inherits from

cellgridcellsectionhead
strong<strong>
document

Content with strong importance, seriousness, or urgency.

Inherits from

section
subscript<sub>
document

Inline text displayed lowered with smaller type, used for typographical conventions.

Inherits from

section
superscript<sup>
document

Inline text displayed raised with smaller type, used for typographical conventions.

Inherits from

section
table<table>
document

A section containing data arranged in rows and columns, similar to an HTML table.

Supported attributes

aria-colcountaria-labelaria-labelledbyaria-rowcount

Required owned elements

rowrowgroup

Inherits from

section
term<dt>
document

A word or phrase with a corresponding definition.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
time<time>
document

A span representing a specific point or range of time.

Inherits from

section
toolbar
document

A collection of commonly used function buttons or controls.

Supported attributes

aria-labelaria-labelledbyaria-orientation

Inherits from

group
tooltip
document

A contextual popup that displays a description for an element.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
banner<header> (top-level)
landmark

A site-oriented content area, typically at the top of the page, e.g. the site logo, main navigation, or search.

Supported attributes

aria-labelaria-labelledby

Inherits from

landmark
complementary<aside>
landmark

A section of the document that supports but is separable from the main content.

Supported attributes

aria-labelaria-labelledby

Inherits from

landmark
contentinfo<footer> (top-level)
landmark

The footer of the page, typically containing copyright information, legal notices, or contact links.

Supported attributes

aria-labelaria-labelledby

Inherits from

landmark
form<form> (with accessible name)
landmark

A landmark region that contains a collection of items and objects that, as a whole, combine to create a form.

Supported attributes

aria-labelaria-labelledby

Inherits from

landmark
main<main>
landmark

The main content of a document.

Supported attributes

aria-labelaria-labelledby

Inherits from

landmark
navigation<nav>
landmark

A collection of navigational elements (usually links) for navigating the document or related documents.

Supported attributes

aria-labelaria-labelledby

Inherits from

landmark
region<section> (with accessible name)
landmark

A perceivable section containing content relevant to a specific purpose, labelled so users can navigate to it.

Supported attributes

aria-labelaria-labelledby

Inherits from

landmark
search<search>
landmark

A landmark containing the site search functionality.

Supported attributes

aria-labelaria-labelledby

Inherits from

landmark
alert
live

An important, usually time-sensitive message. Announced immediately by screen readers.

Supported attributes

aria-atomicaria-livearia-relevant

Inherits from

section
log
live

A type of live region where new information is appended in a meaningful order, e.g. a chat log.

Supported attributes

aria-atomicaria-livearia-relevant

Inherits from

section
marquee
live

A type of live region where non-essential information changes frequently, e.g. a stock ticker.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
status
live

A live region containing advisory information for the user, with lower urgency than an alert.

Supported attributes

aria-atomicaria-livearia-relevant

Inherits from

section
timer
live

A numerical counter indicating elapsed or remaining time.

Supported attributes

aria-atomicaria-labelaria-labelledbyaria-live

Inherits from

section
button<button>
widget

An interactive element activated by a user to trigger an action.

Supported attributes

aria-disabledaria-expandedaria-haspopuparia-pressed

Inherits from

command
checkbox<input type="checkbox">
widget

A checkable input that has three possible states: true, false, or mixed.

Required attributes

aria-checked

Supported attributes

aria-disabledaria-errormessagearia-invalidaria-readonlyaria-required

Inherits from

input
combobox<select> (editable combination)
widget

An input widget that can show a listbox popup with options. Combines a text input with a dropdown.

Required attributes

aria-controlsaria-expanded

Supported attributes

aria-activedescendantaria-autocompletearia-disabledaria-errormessagearia-haspopuparia-invalidaria-labelaria-labelledbyaria-readonlyaria-required

Inherits from

input
link<a href>
widget

An interactive reference to an internal or external resource that, when activated, causes navigation.

Supported attributes

aria-disabledaria-expandedaria-haspopup

Inherits from

command
listbox<select>
widget

A widget that allows the user to select one or more items from a list.

Supported attributes

aria-activedescendantaria-disabledaria-errormessagearia-expandedaria-invalidaria-labelaria-labelledbyaria-multiselectablearia-orientationaria-requiredaria-readonly

Required owned elements

option

Inherits from

select
menu
widget

A list of choices offered to the user, like a context menu or action menu.

Supported attributes

aria-activedescendantaria-labelaria-labelledbyaria-orientation

Required owned elements

menuitemmenuitemcheckboxmenuitemradio

Inherits from

select
menubar
widget

A horizontal menu bar, commonly found at the top of desktop-like application interfaces.

Supported attributes

aria-activedescendantaria-labelaria-labelledbyaria-orientation

Required owned elements

menuitemmenuitemcheckboxmenuitemradio

Inherits from

menu
menuitem
widget

An option in a menu.

Supported attributes

aria-disabledaria-expandedaria-haspopuparia-posinsetaria-setsize

Required context (parent)

menumenubar

Inherits from

command
menuitemcheckbox
widget

A menuitem with a checkable state.

Required attributes

aria-checked

Supported attributes

aria-disabledaria-expandedaria-posinsetaria-setsize

Required context (parent)

menumenubar

Inherits from

checkboxmenuitem
menuitemradio
widget

A checkable menuitem in a group where only one item can be checked at a time.

Required attributes

aria-checked

Supported attributes

aria-disabledaria-expandedaria-posinsetaria-setsize

Required context (parent)

menumenubar

Inherits from

menuitemcheckboxradio
option<option>
widget

A selectable item in a listbox.

Supported attributes

aria-checkedaria-disabledaria-posinsetaria-selectedaria-setsize

Required context (parent)

listbox

Inherits from

input
progressbar<progress>
widget

An element that displays the progress status of a task.

Supported attributes

aria-labelaria-labelledbyaria-valuemaxaria-valueminaria-valuenowaria-valuetext

Inherits from

rangewidget
radio<input type="radio">
widget

A checkable input in a group where only one can be checked at a time.

Required attributes

aria-checked

Supported attributes

aria-disabledaria-posinsetaria-requiredaria-setsize

Inherits from

input
radiogroup<fieldset> (radio)
widget

A group of radio buttons.

Supported attributes

aria-disabledaria-errormessagearia-invalidaria-labelaria-labelledbyaria-orientationaria-readonlyaria-required

Required owned elements

radio

Inherits from

select
scrollbar
widget

A graphical object that controls the scrolling of content within a viewing area.

Required attributes

aria-controlsaria-valuenow

Supported attributes

aria-disabledaria-labelaria-labelledbyaria-orientationaria-valuemaxaria-valueminaria-valuetext

Inherits from

range
searchbox<input type="search">
widget

A type of textbox intended for specifying search criteria.

Supported attributes

aria-activedescendantaria-autocompletearia-disabledaria-errormessagearia-haspopuparia-invalidaria-labelaria-labelledbyaria-multilinearia-placeholderaria-readonlyaria-required

Inherits from

textbox
separator<hr>
widget

A divider that separates and distinguishes sections of content. When focusable, acts as a splitter.

Supported attributes

aria-disabledaria-labelaria-labelledbyaria-orientationaria-valuemaxaria-valueminaria-valuenowaria-valuetext

Inherits from

structurewidget
slider<input type="range">
widget

An input where the user selects a value from within a given range.

Required attributes

aria-valuenow

Supported attributes

aria-disabledaria-errormessagearia-haspopuparia-invalidaria-labelaria-labelledbyaria-orientationaria-readonlyaria-requiredaria-valuemaxaria-valueminaria-valuetext

Inherits from

inputrange
spinbutton<input type="number">
widget

A form of range that expects the user to select from among discrete choices.

Supported attributes

aria-activedescendantaria-disabledaria-errormessagearia-invalidaria-labelaria-labelledbyaria-readonlyaria-requiredaria-valuemaxaria-valueminaria-valuenowaria-valuetext

Inherits from

compositeinputrange
switch
widget

A type of checkbox that represents an on/off value, as opposed to checked/unchecked.

Required attributes

aria-checked

Supported attributes

aria-disabledaria-labelaria-labelledbyaria-readonlyaria-required

Inherits from

checkbox
tab
widget

A grouping label providing a mechanism for selecting the tab content that is to be rendered.

Supported attributes

aria-disabledaria-expandedaria-haspopuparia-labelaria-labelledbyaria-posinsetaria-selectedaria-setsize

Required context (parent)

tablist

Inherits from

sectionheadwidget
tablist
widget

A list of tab elements, which are references to tabpanel elements.

Supported attributes

aria-activedescendantaria-labelaria-labelledbyaria-multiselectablearia-orientation

Required owned elements

tab

Inherits from

composite
tabpanel
widget

A container for the resources associated with a tab.

Supported attributes

aria-labelaria-labelledby

Inherits from

section
textbox<input type="text">, <textarea>
widget

A type of input that allows free-form text as its value.

Supported attributes

aria-activedescendantaria-autocompletearia-disabledaria-errormessagearia-haspopuparia-invalidaria-labelaria-labelledbyaria-multilinearia-placeholderaria-readonlyaria-required

Inherits from

input
tree
widget

A hierarchical list widget where some items can be expanded to reveal child items.

Supported attributes

aria-activedescendantaria-disabledaria-errormessagearia-invalidaria-labelaria-labelledbyaria-multiselectablearia-orientationaria-required

Required owned elements

treeitem

Inherits from

select
treegrid
widget

A grid whose rows can be expanded and collapsed in the same manner as a tree.

Supported attributes

aria-activedescendantaria-colcountaria-disabledaria-labelaria-labelledbyaria-multiselectablearia-orientationaria-readonlyaria-requiredaria-rowcount

Required owned elements

row

Inherits from

gridtree
treeitem
widget

An option item of a tree. Can be expanded/collapsed if it contains child items.

Supported attributes

aria-checkedaria-disabledaria-expandedaria-haspopuparia-labelaria-labelledbyaria-levelaria-posinsetaria-selectedaria-setsize

Required context (parent)

grouptree

Inherits from

listitemoption
alertdialog
window

A type of dialog that contains an alert message and where the initial focus goes to an element within the dialog.

Required attributes

aria-describedbyaria-labelledby

Supported attributes

aria-labelaria-modal

Inherits from

alertdialog
dialog<dialog>
window

A dialogue box or other sub-window floating above the application.

Supported attributes

aria-labelaria-labelledbyaria-modal

Inherits from

window