ARIA 1.2 Vocabulary
ARIA Role Reference
Browse roles defined in WAI-ARIA 1.2 with plain-language summaries and structural data (required attributes, implicit defaults, prohibited attributes, and more).
alert
A type of live region with important, and usually time-sensitive, information.
alertdialog
A type of dialog that contains an alert message, where initial focus goes to an element within the dialog.
article
A section of a page that consists of a composition that forms an independent part of a document, page, or site. An article is not a navigational landmark.
banner
A landmark that contains mostly site-oriented content, rather than page-specific content. Corresponds to the HTML header element when it is not nested within article, aside, main, nav, or section.
button
An input that allows for user-triggered actions when clicked or pressed.
columnheader
A cell containing header information for a column.
combobox
An input that controls another element, such as a listbox or grid, that can dynamically pop up to help the user set the value of the input.
complementary
A landmark that is designed to be complementary to the main content at a similar level in the DOM hierarchy, but remaining meaningful when separated from the main content. Corresponds to the HTML aside element.
contentinfo
A landmark that contains information about the parent document. Corresponds to the HTML footer element when it is not nested within article, aside, main, nav, or section.
feed
A dynamic, scrollable list of articles, where articles may be added to or removed from either end of the list as the user scrolls.
grid
A composite widget containing a collection of one or more rows with one or more cells, where some or all cells are focusable using two-dimensional navigation such as arrow keys. It does not imply a specific visual presentation; authors should manage focus of its descendants for keyboard accessibility.
gridcell
A cell in a grid or treegrid.
group
A set of user interface objects which are not intended to be included in a page summary or table of contents by assistive technologies.
link
An interactive reference to an internal or external resource that, when activated, causes the user agent to navigate to that resource.
listbox
A widget that allows the user to select one or more items from a list of choices.
main
A landmark that contains the main content of a document. Corresponds to the HTML main element.
menu
A widget that offers a list of choices to the user, often a list of common actions or functions the user can invoke.
menubar
A presentation of menu that usually remains visible and is typically presented horizontally, used to create a menu bar of frequently used commands.
menuitem
An option in a set of choices contained by a menu or menubar. When its aria-haspopup attribute is set to true, activating it should display a sub-level menu.
meter
An element that represents a scalar measurement within a known range, or a fractional value; it should not be used to indicate progress, for which the progressbar role exists.
navigation
A landmark composed of navigational elements, usually links. Corresponds to the HTML nav element.
option
A selectable item in a listbox, which must be contained in, or owned by, an element with the role listbox or a group within a listbox.
region
A landmark containing content relevant to a specific, author-specified purpose that is important enough for users to want to navigate to; each region must be given a brief label.
row
A row of cells in a tabular container such as a table, grid, or treegrid; hierarchy-related properties like aria-expanded and aria-level apply only to rows within a treegrid.
separator
A divider that separates sections of content or groups of menuitems. It is treated as a static structural element when not focusable, and as a focusable, movable widget when it is.
slider
An input where the user selects a value from within a given range, representing the range via the size of the slider and the current value via the position of the thumb. Typically adjusted with directional keys such as arrow keys.
spinbutton
A form of range that expects the user to select from among discrete choices, typically by activating increment and decrement controls that step through the allowed values. For large value ranges it is advisable over listing distinct options.
switch
A type of checkbox that represents on/off values rather than checked/unchecked values; the mixed value of aria-checked is invalid and treated as false for this role.
tab
An element in a tablist that provides a mechanism for selecting the tab content to be rendered. When selected, its associated tabpanel is expected to become visible.
tablist
A container for a set of tab elements, each of which refers to a tabpanel.
tabpanel
A container for the resources associated with a tab; each tab is contained in a tablist.
toolbar
A collection of commonly used function buttons or controls represented in compact visual form, often a subset of the functions found in a menubar. When there is more than one toolbar, each must have a label.
tooltip
A contextual popup that displays a description for an element; it should be referenced from the described element with aria-describedby. Typically becomes visible after a short delay in response to mouse hover or keyboard focus.
tree
A widget that allows the user to select one or more items from a hierarchically organized collection.
treegrid
A grid whose rows can be expanded and collapsed in the same manner as items in a tree.
treeitem
An option item of a tree; an element within a tree that may be expanded or collapsed if it contains a sub-level group of treeitem elements.