ARIA Roles for Common HTML Elements

ARIA Role Assignments for Common HTML Elements

This table identifies the most common user-focused HTML elements with their corresponding ARIA role assignment.  ARIA semantics only exposes extra information to a browser’s accessibility API without affecting a page’s DOM.

HTML Element
ARIA role
Description

Accordion

Button An accordion is a vertically stacked set of interactive headings, where each contain a title, content snippet, or thumbnail representing a section of content, where the content/thumbnail can be revealed or hidden upon user selection.

Alert

Alert An alert is an element that displays a brief, important message in a way that attracts the user’s attention without interrupting the user’s task or affect keyboard focus.

Alert and Message Dialogs

Alertdialog An alert dialog is a modal dialog that interrupts the user’s workflow to communicate an important message and acquire a response.

Breadcrumb

(none) A breadcrumb trail consists of a list of links to the parent pages of the current page in hierarchical order to help users find their place.

Button

Button A button is a widget that enables users to trigger an action or event, such as submitting a form, opening a dialog, canceling an action, or performing a delete operation.

Carousel (Slide Show or Image Rotator)

Group A carousel presents a set of items, referred to as slides, by sequentially displaying a subset of one or more slides in a rotating manner.

Checkbox

Checkbox A checkbox allows user to indicate a selected, partially selected, or not selected state.

Combo Box

Combobox A combobox enables user to set the value or identify the selection via a listbox, grid, tree, or dialog.

Dialog (Modal)

Dialog A dialog is a window overlaid (to obscure) on either the primary window or another dialog window to provide user with specific information or needed interaction.

Disclosure (Show/Hide)

Button A disclosure is a button that controls visibility of a section of content and notating when the content is visible or hidden.

Feed

Feed A feed is a section of a page that automatically loads new sections of content as the user scrolls.

Grid

Grid A grid widget is a container (of tabular data) that enables users to navigate the information or interactive elements it contains using directional navigation keys, such as arrow keys, Home, and End.

Link

Link A link widget provides an interactive reference to a resource that is within the current page or application or external source.

Listbox

Listbox A listbox widget presents a list of options and allows a user to select one or more of them.

Menu

Menu A menu is a widget that offers a list of choices to the user, such as a set of actions, functions, commands, or submenu items.

Menu Bar

Menubar A menu bar is a menu that is visually persistent to offer the user quick access to a consistent set of commands or options.

Menu Button

Button A menu button is a button that opens a menu.

Menu Item

Menuitem A menu item is a user-selectable element within a menu.

Radio Group

Radiogroup A radio group is a set of selectable options, known as radio buttons, where no more than one of the options can be selected at a time.

Slider

Slider A slider is an input where the user selects a value from within a given range typically by moving a slider thumb along a bar or track to change the slider value.

Slider (Multi-Thumb)

Slider A multi-thumb slider is a slider with two or more thumbs that each set a value in a group of related values.

Spinbutton

Spinbutton A spinbutton is an input widget that restricts the user-selected value to a set or range of discrete values.

Table

Table An WAI-ARIA table is a static (non-interactive) tabular structure containing one or more rows that each contain one or more cells that are not focusable or selectable.

Tabs

Tablist Tabs are a set of layered sections of content, known as tab panels, that display one panel of content at a time when activated.

Toolbar

Toolbar A toolbar is a container for grouping a set of controls, such as buttons, menubuttons, or checkboxes.

Tooltip

Tooltip A tooltip is a popup that displays information related to an element when the element receives keyboard focus or the mouse hovers over it.

Tree View

Tree A tree view widget presents a hierarchical list where any item in the hierarchy may have child items that may be expanded or collapsed to show or hide the children.

Treegrid

Treegrid A treegrid widget presents a hierarchical data grid consisting of tabular information that is editable or interactive.

Window Splitter

Separator A window splitter is a moveable separator between two sections, or panes, of a window that enables users to change the relative size of the panes.

View More Resources

 

error: Protected Content