ARIA Role Reference
Complete WAI-ARIA role reference. Search, filter by category, view required attributes, keyboard interactions, and use the role recommendation wizard.
Showing 34 of 34 roles
mainLandmarkThe primary content of the document. Only one main landmark per page.
complementaryLandmarkA supporting section of the document, designed to be complementary to the main content.
contentinfoLandmarkA perceivable region that contains information about the parent document (e.g., copyright, links to privacy statement). Typically the page footer.
formLandmarkA landmark region that contains a collection of items and objects that, as a whole, combine to create a form.
regionLandmarkA perceivable section of the page containing content that is sufficiently important for users to be able to navigate to the section.
searchLandmarkA landmark region that contains the items and objects that as a whole combine to create a search facility.
checkboxWidgetA checkable input that has three possible values: true, false, or mixed.
dialogWidgetA dialog is a descendant window of the primary window of a web application in which content within the dialog is focused.
gridcellWidgetA cell in a grid or treegrid. Gridcells may contain focusable and editable content.
linkWidgetAn interactive reference to an internal or external resource that, when activated, causes the user agent to navigate to that resource.
optionWidgetA selectable item in a select list. Used within a listbox.
radioWidgetA checkable input in a group of radio roles, only one of which can be checked at a time.
sliderWidgetA user input where the user selects a value from within a given range.
switchWidgetA type of checkbox that represents on/off values, as opposed to checked/unchecked values.
tabWidgetAn interactive element inside a tablist that, when activated, displays its associated tabpanel.
textboxWidgetA type of input that allows free-form text as its value.
articleDocument StructureA section of a page that consists of a composition that forms an independent part of a document, page, or site.
definitionDocument StructureA definition of a term or concept.
figureDocument StructureA section of content that could be moved out of the main flow without affecting the meaning of the document.
groupDocument StructureA set of user interface objects which are not intended to be included in a page summary or table of contents by assistive technologies.
headingDocument StructureA heading for a section of the page. Use native h1-h6 elements when possible.
imgDocument StructureA container for a collection of elements that form an image. Use when multiple DOM elements together form an image.
listDocument StructureA section containing listitem elements. Prefer native ul/ol elements.
tableDocument StructureA section containing data arranged in rows and columns. Prefer native table elements.
toolbarDocument StructureA collection of commonly used function buttons or controls represented in a compact visual form.
alertLive RegionA live region containing an important, usually time-sensitive, message. Announced immediately by screen readers.
logLive RegionA type of live region where new information is added in meaningful order. The log also supports a limited interaction model.
marqueeLive RegionA type of live region where non-essential information changes frequently. Screen readers may not announce changes by default.
statusLive RegionA live region that contains advisory information for the user but is not important enough to justify an alert. Announced politely.
timerLive RegionA numerical counter which indicates an amount of elapsed time from a start point, or the time remaining until an end point.