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

bannerLandmark

A region that contains mostly site-oriented content, rather than page-specific content. Typically the site header.

navigationLandmark

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

mainLandmark

The primary content of the document. Only one main landmark per page.

complementaryLandmark

A supporting section of the document, designed to be complementary to the main content.

contentinfoLandmark

A perceivable region that contains information about the parent document (e.g., copyright, links to privacy statement). Typically the page footer.

formLandmark

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

regionLandmark

A perceivable section of the page containing content that is sufficiently important for users to be able to navigate to the section.

buttonWidget

An input that allows users to trigger actions or events. Use a native <button> element when possible.

checkboxWidget

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

dialogWidget

A dialog is a descendant window of the primary window of a web application in which content within the dialog is focused.

gridcellWidget

A cell in a grid or treegrid. Gridcells may contain focusable and editable content.

menuitemWidget

An option in a set of choices contained by a menu or menubar.

optionWidget

A selectable item in a select list. Used within a listbox.

radioWidget

A checkable input in a group of radio roles, only one of which can be checked at a time.

sliderWidget

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

switchWidget

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

tabWidget

An interactive element inside a tablist that, when activated, displays its associated tabpanel.

textboxWidget

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

articleDocument Structure

A section of a page that consists of a composition that forms an independent part of a document, page, or site.

definitionDocument Structure

A definition of a term or concept.

figureDocument Structure

A section of content that could be moved out of the main flow without affecting the meaning of the document.

groupDocument Structure

A set of user interface objects which are not intended to be included in a page summary or table of contents by assistive technologies.

headingDocument Structure

A heading for a section of the page. Use native h1-h6 elements when possible.

imgDocument Structure

A container for a collection of elements that form an image. Use when multiple DOM elements together form an image.

listDocument Structure

A section containing listitem elements. Prefer native ul/ol elements.

tableDocument Structure

A section containing data arranged in rows and columns. Prefer native table elements.

toolbarDocument Structure

A collection of commonly used function buttons or controls represented in a compact visual form.

alertLive Region

A live region containing an important, usually time-sensitive, message. Announced immediately by screen readers.

logLive Region

A type of live region where new information is added in meaningful order. The log also supports a limited interaction model.

marqueeLive Region

A type of live region where non-essential information changes frequently. Screen readers may not announce changes by default.

statusLive Region

A live region that contains advisory information for the user but is not important enough to justify an alert. Announced politely.

timerLive Region

A numerical counter which indicates an amount of elapsed time from a start point, or the time remaining until an end point.