ARIA Reference
Guide
Complete reference for ARIA roles and attributes. Build accessible web applications with confidence
Browse ReferenceWCAG Compliant
Follow accessibility standards
Comprehensive
All roles and attributes covered
Easy Search
Find what you need quickly
Widget Roles20
buttonroleAn input that allows for user-triggered actions
checkboxroleA checkable input with three possible values: true, false, or mixed
gridcellroleA cell in a grid or treegrid
linkroleAn interactive reference to an internal or external resource
menuitemroleAn option in a set of choices contained by a menu or menubar
menuitemcheckboxroleA checkable menuitem with three possible values: true, false, or mixed
menuitemradioroleA checkable menuitem in a set of elements with the same role
optionroleA selectable item in a listbox
progressbarroleAn element that displays the progress status for tasks that take a long time
radioroleA checkable input in a group of radio roles, only one of which can be checked at a time
scrollbarroleA graphical object that controls the scrolling of content within a viewing area
searchboxroleA type of textbox intended for specifying search criteria
separatorroleA divider that separates and distinguishes sections of content or groups of menuitems
sliderroleAn input where the user selects a value from within a given range
spinbuttonroleA form of range that expects the user to select from among discrete choices
switchroleA type of checkbox that represents on/off values
tabroleA grouping label providing a mechanism for selecting the tab content that is to be rendered to the user
tabpanelroleA container for the resources associated with a tab
textboxroleAn input that allows free-form text as its value
treeitemroleAn option item of a tree
Composite Roles9
comboboxroleAn input that controls another element that can dynamically pop up to help the user set the value
gridroleA composite widget containing a collection of one or more rows with one or more cells
listboxroleA widget that allows the user to select one or more items from a list of choices
menuroleA type of widget that offers a list of choices to the user
menubarroleA presentation of menu that usually remains visible and is usually presented horizontally
radiogrouproleA group of radio buttons
tablistroleA list of tab elements, which are references to tabpanel elements
treeroleA widget that allows the user to select one or more items from a hierarchically organized collection
treegridroleA grid whose rows can be expanded and collapsed in the same manner as for a tree
Document Structure Roles25
applicationroleA structure containing one or more focusable elements requiring user input
articleroleA section of a page that consists of a composition that forms an independent part of a document
cellroleA cell in a tabular container
columnheaderroleA cell containing header information for a column
definitionroleA definition of a term or concept
directoryroleA list of references to members of a group
documentroleAn element containing content that assistive technology users may want to browse in a reading mode
feedroleA scrollable list of articles where scrolling may cause articles to be added or removed from either end of the list
figureroleA perceivable section of content that typically contains a graphical document, images, code snippets, or example text
grouproleA set of user interface objects which are not intended to be included in a page summary or table of contents
headingroleA heading for a section of the page
imgroleA container for a collection of elements that form an image
listroleA section containing listitem elements
listitemroleA single item in a list or directory
mathroleContent that represents a mathematical expression
noneroleAn element whose implicit native role semantics will not be mapped to the accessibility API
noteroleA section whose content is parenthetic or ancillary to the main content of the resource
presentationroleAn element whose implicit native role semantics will not be mapped to the accessibility API
rowroleA row of cells in a tabular container
rowgrouproleA group containing one or more row elements in a grid, table, or treegrid
rowheaderroleA cell containing header information for a row in a grid, table, or treegrid
tableroleA section containing data arranged in rows and columns
termroleA word or phrase with a corresponding definition
toolbarroleA collection of commonly used function buttons or controls represented in compact visual form
tooltiproleA contextual popup that displays a description for an element
Landmark Roles8
bannerroleA region that contains mostly site-oriented content, rather than page-specific content
complementaryroleA supporting section of the document, designed to be complementary to the main content
contentinforoleA large perceivable region that contains information about the parent document
formroleA landmark region that contains a collection of items and objects that, as a whole, combine to create a form
mainroleThe main content of a document
navigationroleA collection of navigational elements for navigating the document or related documents
regionroleA perceivable section containing content that is relevant to a specific, author-specified purpose
searchroleA landmark region that contains a collection of items and objects that, as a whole, combine to create a search facility
Live Region Roles5
alertroleA type of live region with important, and usually time-sensitive, information
logroleA type of live region where new information is added in meaningful order and old information may disappear
marqueeroleA type of live region where non-essential information changes frequently
statusroleA type of live region whose content is advisory information for the user but is not important enough to justify an alert
timerroleA type of live region containing a numerical counter which indicates an amount of elapsed time or remaining time
Window Roles2
Widget Attributes25
aria-autocompleteattributeIndicates whether inputting text could trigger display of one or more predictions of the user's intended value
aria-checkedattributeIndicates the current "checked" state of checkboxes, radio buttons, and other widgets
aria-currentattributeIndicates the element that represents the current item within a container or set of related elements
aria-disabledattributeIndicates that the element is perceivable but disabled, so it is not editable or otherwise operable
aria-errormessageattributeIdentifies the element that provides an error message for an object
aria-expandedattributeIndicates whether a grouping element owned or controlled by this element is expanded or collapsed
aria-haspopupattributeIndicates the availability and type of interactive popup element
aria-hiddenattributeIndicates whether the element is exposed to an accessibility API
aria-invalidattributeIndicates the entered value does not conform to the format expected by the application
aria-labelattributeDefines a string value that labels the current element
aria-levelattributeDefines the hierarchical level of an element within a structure
aria-modalattributeIndicates whether an element is modal when displayed
aria-multilineattributeIndicates whether a text box accepts multiple lines of input or only a single line
aria-multiselectableattributeIndicates that the user may select more than one item from the current selectable descendants
aria-orientationattributeIndicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous
aria-placeholderattributeDefines a short hint intended to aid the user with data entry when the control has no value
aria-pressedattributeIndicates the current "pressed" state of toggle buttons
aria-readonlyattributeIndicates that the element is not editable, but is otherwise operable
aria-requiredattributeIndicates that user input is required on the element before a form may be submitted
aria-selectedattributeIndicates the current "selected" state of various widgets
aria-sortattributeIndicates if items in a table or grid are sorted in ascending or descending order
aria-valuemaxattributeDefines the maximum allowed value for a range widget
aria-valueminattributeDefines the minimum allowed value for a range widget
aria-valuenowattributeDefines the current value for a range widget
aria-valuetextattributeDefines the human readable text alternative of aria-valuenow for a range widget
Live Region Attributes4
aria-liveattributeIndicates that an element will be updated, and describes the types of updates the user can expect
aria-relevantattributeIndicates what notifications the user agent will trigger when the accessibility tree within a live region is modified
aria-atomicattributeIndicates whether assistive technologies will present all, or only parts of, the changed region
aria-busyattributeIndicates an element is being modified and that assistive technologies may want to wait until the modifications are complete
Relationship Attributes15
aria-activedescendantattributeIdentifies the currently active element when focus is on a composite widget, combobox, textbox, group, or application
aria-colcountattributeDefines the total number of columns in a table, grid, or treegrid
aria-colindexattributeDefines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid
aria-colspanattributeDefines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid
aria-controlsattributeIdentifies the element (or elements) whose contents or presence are controlled by the current element
aria-describedbyattributeIdentifies the element (or elements) that describes the object
aria-detailsattributeIdentifies the element that provides a detailed, extended description for the object
aria-flowtoattributeIdentifies the next element (or elements) in an alternate reading order of content
aria-labelledbyattributeIdentifies the element (or elements) that labels the current element
aria-ownsattributeIdentifies an element (or elements) in order to define a visual, functional, or contextual parent/child relationship
aria-posinsetattributeDefines an element's number or position in the current set of listitems or treeitems
aria-rowcountattributeDefines the total number of rows in a table, grid, or treegrid
aria-rowindexattributeDefines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid
aria-rowspanattributeDefines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid
aria-setsizeattributeDefines the number of items in the current set of listitems or treeitems