ARIARole
Defines all possible ARIA (Accessible Rich Internet Applications) role values that can be used to identify elements by their semantic meaning. These roles help assistive technologies understand the purpose and behavior of page elements. Based on the WAI-ARIA specification.
Definition
Values
ALERT
A type of live region with important, and usually time-sensitive, information. Example: error messages, warnings.
ALERTDIALOG
A modal dialog that interrupts the user’s workflow to communicate an important message and acquire a response. Example: confirmation dialogs, error dialogs.
APPLICATION
A region declared as a web application, as opposed to a web document. Example: interactive web apps, games.
ARTICLE
A section of a page that consists of a composition that forms an independent part of a document. Example: blog posts, news articles.
BANNER
A region that contains mostly site-oriented content, rather than page-specific content. Example: site headers, logos, navigation.
BLOCKQUOTE
A section of content that is quoted from another source. Example: testimonials, cited text blocks.
BUTTON
An input that allows for user-triggered actions when clicked or pressed. Example: submit buttons, toggle buttons.
CAPTION
Visible content that serves as a label for, and may provide a summary of, the purpose of a table or figure. Example: table captions, figure captions.
CELL
A cell in a tabular container. Example: table cells, grid cells.
CHECKBOX
A checkable input that has three possible values: true, false, or mixed. Example: form checkboxes, multi-select options.
CODE
A section whose content represents a fragment of computer code. Example: code snippets, programming examples.
COLUMNHEADER
A cell containing header information for a column. Example: table column headers, grid column headers.
COMBOBOX
A composite widget containing a single-line textbox and another element, such as a listbox or grid, that can dynamically pop up to help the user set the value of the textbox. Example: autocomplete inputs, dropdown selects.
COMPLEMENTARY
A landmark region that is designed to be complementary to the main content. Example: sidebars, related links, advertisements.
CONTENTINFO
A landmark region that contains information about the parent document. Example: page footers, copyright information.
DEFINITION
A definition of a term or concept. Example: dictionary definitions, glossary terms.
DELETION
A removal from the content. Example: deleted text in document revisions, strikethrough content.
DIALOG
A dialog is a descendant window of the primary window of a web application. Example: modal dialogs, popup windows.
DIRECTORY
A list of references to members of a group, such as a static table of contents. Example: site directories, member lists.
DOCUMENT
A region containing related information that is declared as document content. Example: article content, document body.
EMPHASIS
One or more emphasized characters. Example: italic text, highlighted content.
FEED
A scrollable list of articles where scrolling may cause articles to be added to or removed from either end of the list. Example: social media feeds, news feeds.
FIGURE
A perceivable section of content that typically contains a graphical document, images, code snippets, or example text. Example: images with captions, code examples.
FORM
A landmark region that contains a collection of items and objects that, as a whole, combine to create a form. Example: login forms, contact forms.
GENERIC
A generic container element that does not have any semantic meaning. Example: div elements, span elements used for styling.
GRID
A composite widget containing a collection of one or more rows with one or more cells. Example: data grids, spreadsheet-like interfaces.
GRIDCELL
A cell in a grid or treegrid. Example: individual cells in data grids, spreadsheet cells.
GROUP
A set of user interface objects which are not intended to be included in a page summary by assistive technologies. Example: grouped form controls, toolbar groups.
HEADING
A heading for a section of the page. Example: h1-h6 elements, section headings.
IMG
A container for a collection of elements that form an image. Example: image elements, graphic content.
INSERTION
An addition to the content. Example: inserted text in document revisions, newly added content.
LINK
An interactive reference to an internal or external resource. Example: hyperlinks, navigation links.
LIST
A group of non-interactive list items. Example: unordered lists, ordered lists.
LISTBOX
A widget that allows the user to select one or more items from a list of choices. Example: select dropdowns, multi-select lists.
LISTITEM
A single item in a list or directory. Example: li elements, menu items.
LOG
A type of live region where new information is added in meaningful order and old information may disappear. Example: chat logs, activity feeds.
MAIN
The main content of a document. Example: primary content area, main article content.
MARQUEE
A type of live region where non-essential information changes frequently. Example: stock tickers, news tickers.
MATH
Content that represents a mathematical expression. Example: mathematical equations, formulas.
METER
An element that displays a scalar value within a known range or a fractional value. Example: progress indicators, usage meters.
MENU
A type of widget that offers a list of choices to the user. Example: context menus, dropdown menus.
MENUBAR
A presentation of menu that usually remains visible and is usually presented horizontally. Example: application menu bars, navigation bars.
MENUITEM
An option in a set of choices contained by a menu or menubar. Example: individual menu options, dropdown items.
MENUITEMCHECKBOX
A menuitem with a checkable state whose possible values are true, false, or mixed. Example: toggle menu items, checkable options.
MENUITEMRADIO
A checkable menuitem in a set of elements with the same role, only one of which can be checked at a time. Example: radio menu items, exclusive options.
NAVIGATION
A landmark region that contains a collection of navigational elements. Example: site navigation, breadcrumbs.
NONE
An element whose implicit native role semantics will not be mapped to the accessibility API. Example: decorative elements, layout containers.
NOTE
A section whose content is parenthetic or ancillary to the main content. Example: footnotes, side notes.
OPTION
A selectable item in a select list. Example: option elements, listbox items.
PARAGRAPH
A paragraph of content. Example: p elements, text blocks.
PRESENTATION
An element whose implicit native role semantics will not be mapped to the accessibility API. Example: decorative images, layout tables.
PROGRESSBAR
An element that displays the progress status for tasks that take a long time. Example: loading bars, upload progress.
RADIO
A checkable input in a group of radio roles, only one of which can be checked at a time. Example: radio buttons, exclusive choices.
RADIOGROUP
A group of radio buttons. Example: radio button groups, exclusive option sets.
REGION
A perceivable section containing content that is relevant to a specific, author-specified purpose. Example: content sections, widget areas.
ROW
A row of cells in a tabular container. Example: table rows, grid rows.
ROWGROUP
A group containing one or more row elements in a tabular container. Example: table tbody, thead, tfoot.
ROWHEADER
A cell containing header information for a row. Example: table row headers, grid row headers.
SCROLLBAR
A graphical object that controls the scrolling of content within a viewing area. Example: scroll bars, range sliders.
SEARCH
A landmark region that contains a collection of items and objects that, as a whole, combine to create a search facility. Example: search forms, search interfaces.
SEARCHBOX
A type of textbox intended for specifying search criteria. Example: search input fields, query boxes.
SEPARATOR
A divider that separates and distinguishes sections of content or groups of menuitems. Example: horizontal rules, dividers.
SLIDER
A user input where the user selects a value from within a given range. Example: range sliders, volume controls.
SPINBUTTON
A form of range that expects the user to select from among discrete choices. Example: number inputs with up/down buttons.
STATUS
A type of live region whose content is advisory information for the user but is not important enough to justify an alert. Example: status messages, notifications.
STRONG
Content which is important, serious, or urgent. Example: strong text, important notices.
SUBSCRIPT
One or more subscripted characters. Example: chemical formulas, mathematical subscripts.
SUPERSCRIPT
One or more superscripted characters. Example: mathematical exponents, ordinal indicators.
SWITCH
A type of checkbox that represents on/off values, as opposed to checked/unchecked values. Example: toggle switches, on/off controls.
TAB
A grouping label providing a mechanism for selecting the tab content that is to be rendered to the user. Example: tab buttons, tab headers.
TABLE
A section containing data arranged in rows and columns. Example: data tables, comparison tables.
TABLIST
A list of tab elements, which are references to tabpanel elements. Example: tab navigation, tab headers container.
TABPANEL
A container for the resources associated with a tab. Example: tab content areas, tab panels.
TERM
A word or phrase with a corresponding definition. Example: glossary terms, defined terms.
TEXTBOX
A type of input that allows free-form text as its value. Example: text inputs, text areas.
TIME
An element that represents a specific period in time. Example: time elements, timestamps.
TIMER
A type of live region containing a numerical counter which indicates an amount of elapsed time from a start point, or the time remaining until an end point. Example: countdown timers, stopwatches.
TOOLBAR
A collection of commonly used function buttons or controls represented in compact visual form. Example: formatting toolbars, action bars.
TOOLTIP
A contextual popup that displays a description for an element. Example: help tooltips, hover descriptions.
TREE
A type of list that may contain sub-level nested groups that can be collapsed and expanded. Example: file trees, hierarchical menus.
TREEGRID
A grid whose rows can be expanded and collapsed in the same manner as for a tree. Example: hierarchical data grids, expandable tables.
TREEITEM
An option item of a tree. This is an element within a tree that may be expanded or collapsed. Example: tree nodes, hierarchical list items.