WAI-ARIA 1.1 Roles Flashcards
alert
An assertive live region used to alert the user about important, and usually time-sensitive, information.
- On: the element with the message.
- Focus: none; should not require closing by the user
- Implicit values: aria-live="assertive"
, aria-atomic="true"
alertdialog
A type of dialog that contains an alert message.
- On: node containing alert message and the rest of the dialog
- Focus: an element within the dialog; SHOULD be trapped
- Name: Required. SHOULD use aria-describedby
to reference the message element
application
Contains 1+ focusable elements requiring user input & not following a standard interaction pattern supported by a widget
role.
- On: node containing the entire application functionality
- Focus: Some ATs only surface focusable elements within application
, so author MUST make non-decorative content accessible:
- associate with focusable element using aria-labelledby
or aria-describedby
, OR
- place content in a focusable element with role document
or article
, OR
- manage focus of descendants using aria-activedescendant
- Name: Required, from author.
article
A section/composition that forms an independent part of a document, page, or site.
- Not a navigational landmark.
- May be nested; if so, this indicates that the child article
content relates to the parent article
.
banner
A region that contains mostly site-oriented content (e.g. logo, site search, etc), rather than page-specific content.
- SHOULD be treated as a navigational landmark.
- SHOULD be a single instance in any document
or application
.
- Default on HTML header
button
An input that allows from user-triggered actions when clicked or pressed, mostly used for discrete actions.
- Attributes: optionally supports aria-pressed
(boolean) to create a toggle button.
- name: from contents
- Default for HTML button
cell
A cell in a tabular container.
- MUST be contained in or owned by an element with role row
.
- name: required, from contents
- Default for HTML td
checkbox
A checkable input that has three possible values: true
, false
, and mixed
.
- attributes: aria-checked
indicates the value
- name: required, from contents
- implicit values: aria-checked="false"
- Default for HTML input[type="checkbox"]
columnheader
A cell containing header information for a column, usually in a table (non-interactive) or grid (interactive). Establishes a relationship between itself and all the cells in the corresponding column.
- MUST be contained in or owned by an element with role row
.
- name: required, from contents
- Default for HTML th[scope=["col"]
combobox
A composite widget containing a single-line textbox
or searchbox
and another element, such as listbox
or grid
, that can dynamically pop up to help the user with its value.
- If the textbox
uses autocomplete, aria-autocomplete
MUST be set.
- MUST set aria-expanded
according to its state (defaults to false
)
- When expanded, MUST own/contain a listbox
, tree
, grid
or dialog
as the popup, and MUST set aria-controls
on the textbox
to a value that refers to this element.
- MUST have a value for aria-haspopup
if it is not the default listbox
- Focus: SHOULD initially be on textbox
, and SHOULD be managed among descendants
- Required attributes: aria-controls
and aria-expanded
- Name: required, from author
- Implicit values: aria-expanded="false"
, aria-haspopup="listbox"
command
A form of widget that performs an action but doesn’t receive input data (button
, link
, menuitem
).
- Abstract role, not to be used by authors.
complementary
A supporting section of the document, at the same level as and complementary/relevant to the main content but remaining meaningful on its own.
- SHOULD be treated as navigational landmarks.
- Default for HTML aside
composite
A widget that may contain navigable descendants or owned children.
- Abstract role, not to be used by authors.
contentinfo
A large perceivable region that contains information about the parent document (e.g. copyright, privacy statements, etc.).
- SHOULD be treated as navigational landmark.
- SHOULD be only one instance in any document
or application
.
- Default on HTML footer
definition
A definition of a term or concept.
- SHOULD identify the element (role term
) being defined and reference it with aria-labelledby
.
- Default on HTML dd
dialog
A descendant window of the primary window of the web application (for HTML pages, the body
), most often used to prompt the user to enter or respond to information. When designed to interrupt workflow, it is usually modal.
- SHOULD have a label, via aria-label
or aria-labelledby
- Focus: SHOULD have at least one focusable descendant, which SHOULD be focused when the dialog is modal
directory
A list of references to members of a group.
- SHOULD be used for a static table of contents (linked or unlinked).
document
An element containing content that AT users might want to browse in a ‘reading mode’ (default for all elements except those with widget
or application
roles, so only useful if the element is a descendant of one of these).
feed
A scrollable list
of article
s, where scrolling may cause articles to be added or removed from either end of the list.
- SHOULD have aria-busy="true"
while the list is updating, and false
otherwise.
- MAY include an article
at the end(s) with a button
to load more articles.
- On: a container whose children have role article
- Focus: SHOULD be made possible on each child article
(e.g. using tabindex
in HTML)
figure
A perceivable section of content that contains a graphical document, image, code snippet or example text.
- Parts of a figure MAY be user-navigable.
- SHOULD be referenced from main text.
- MAY provide a label using aria-label
or aria-labelledby
, and MAY reference text serving as a caption using aria-describedby
.
- Default for HTML figure
form
A landmark region containing a collection of elements (any mix of host language form controls, scripted controls, and hyperlinks) that together create a form.
- SHOULD have a visible label, referenced with aria-labelledby
.
- Default for HTML form
grid
A composite widget with 1+ cells in 1+ rows forming a grid, where each cell is focusable using methods of two-dimensional navigation (e.g. arrow keys). This role implies only relationships among elements, not specific visuals.
- MUST be structured grid
(> rowgroup
) > row
> gridcell
/rowheader
/columnheader
.
- Focus: SHOULD be managed within; SHOULD be set on the cell itself, but MAY be on a widget within a cell (if it is the only content and doesn’t require arrow keys)
- SHOULD provide a mechanism to operate any interactive content within a cell
gridcell
A cell in a grid
or treegrid
. May be focusable, editable, and selectable, and may have relationships (e.g. aria-controls
).
- SHOULD have aria-describedby
to refer to a rowheader
or columnheader
, if these cannot be determined from DOM structure.
- MUST be contained in or owned by a row
.
group
A set of UI objects which are not intended to be included in a page summary or table of contents by ATs (in contrast to region
).
- SHOULD be used to form a logical collection of items in a widget
.
heading
A heading for a section of the page; often referenced with aria-labelledby
on the section itself.
- name: Required
- implicit values: aria-level="2"
- Default for HTML h1
to h6
.
img
A container for a collection of elements that form an image (a single graphic). Can contain captions and descriptive text, as well as multiple image files that together give the impression of a single image.
- name: Required, from alternative text or label
- Default for HTML img
.
input
A generic type of widget
that allows user input.
landmark
A perceivable section
containing content that is relevant to a specific, author-specified purpose and sufficiently important that users will likely want to be able to navigate to it easily and have it listed in a summary of the page.
- Abstract role, not to be used by authors.
link
An interactive reference to an internal or external resource that, when activated, causes the UA to navigate to that source.
- name: Required, from contents
- Default for HTML a[href]
& link
list
A section
containing listitem
elements (or group
elements which contain listitem
s).
- Default for HTML ol
, ul
.
listbox
A widget
that allows the user to select 1+ items from a list of choices, each as an element with role option
.
- Focus: SHOULD be managed within, applied on descendants.
- Name: required
- Implicit values: aria-orientation="vertical"
- Default for HTML select
.
listitem
A single item in a list or directory.
- MUST be contained in or owned by list
or group
.
- Default for HTML li
.