ARIA Roles, Properties and States Referenced in Guidance and Examples

This page includes information on number of guidance and example references in the WAI-ARIA Authoring Practices for each ARIA role, property and state. The guidance column is determined by either the role, property or state being in the text content of a heading (e.g. h2-h6) or through the use of data-aria-roles or data-aria-props attributes on any heading within the practices. The data-aria-roles or data-aria-props attributes should contain a space separated list of values. The use of the data attribute overrides the identification of roles, properties or states from the text content of a heading. The suffix "(D)" indicates a reference came from a data attribute, otherwise the reference came from the text content of a heading.

CSV Files of Role, Properties and States Coverage
Roles with no Guidance or Examples (22)
Roles with at Least One Guidance or Example (16)
Roles with More than One Guidance or Example (31)
Properties and States with no Examples (14)
Properties and States with One Examples (9)
Properties and States with More than One Example (25)

CSV Files of Role, Properties and States Coverage

Roles with No Guidance or Examples (22)

application
definition
directory
document
figure
heading
img
list
listitem
log
marquee
math
note
progressbar
rowheader
scrollbar
searchbox
status
switch
term
textbox
timer

Roles with at Least One Guidance or Example (16)

Role	Guidance	Example
`alertdialog`	-	Alert Dialog
`article`	-	Feed
`banner`	Banner	Banner Landmark
`columnheader`	-	Table
`complementary`	Complementary	Complementary Landmark
`contentinfo`	Contentinfo	Contentinfo Landmark
`feed`	Feed	Feed
`gridcell`	-	Layout Grid
`link`	Link	Link
`main`	Main	Main Landmark
`menuitemcheckbox`	-	Editor Menubar
`rowgroup`	-	Table
`search`	Search	Search Landmark
`separator`	-	Editor Menubar
`tooltip`	Tooltip Widget	-
`treegrid`	Treegrid	Treegrid Email Inbox

Roles with More than One Guidance or Example (31)

Role	Guidance	Examples
`alert`	Alert Alert and Message Dialogs	Alert
`button`	Button Menu Button	Button (IDL Version) Button
`cell`	Defining cell spans using aria-colspan and aria-rowspan Whether to Focus on a Cell Or an Element Inside It Editing and Navigating Inside a Cell	-
`checkbox`	Checkbox	Checkbox (Two State) Checkbox (Mixed-State)
`combobox`	Combobox Combobox Keyboard Interaction	Editable Combobox With Both List and Inline Autocomplete Editable Combobox With List Autocomplete Editable Combobox without Autocomplete Editable Combobox with Grid Popup
`dialog`	Dialog (Modal) Dialog Popup Keyboard Interaction	Date Picker Dialog Modal Dialog
`form`	Naming Form Controls with the Label Element Form	Form Landmark
`grid`	Grid and Table Properties Grid Popup Keyboard Interaction	Editable Combobox with Grid Popup Date Picker Dialog Data Grid Layout Grid
`group`	Radio Group For Radio Group Contained in a Toolbar	Auto-Rotating Image Carousel Checkbox (Two State) Editor Menubar Date Picker Spin Button Navigation Treeview Using Computed Properties Navigation Treeview Using Declared Properties
`listbox`	Listbox Listbox Popup Keyboard Interaction	Editable Combobox With Both List and Inline Autocomplete Editable Combobox With List Autocomplete Editable Combobox without Autocomplete Collapsible Dropdown Listbox Listbox with Grouped Options Listboxes with Rearrangeable Options Scrollable Listbox
`menu`	Menu or Menu bar Menu Button	Actions Menu Button Using aria-activedescendant Actions Menu Button Using element.focus() Navigation Menu Button Navigation Menubar Editor Menubar Toolbar
`menubar`	-	Navigation Menubar Editor Menubar
`menuitem`	-	Actions Menu Button Using element.focus() Navigation Menu Button Navigation Menubar Editor Menubar
`menuitemradio`	-	Editor Menubar Toolbar
`navigation`	Fundamental Keyboard Navigation Conventions Keyboard Navigation Between Components (The Tab Sequence) Keyboard Navigation Inside Components Ensure Basic Access Via Navigation Navigation	Navigation Landmark
`none`	-	Navigation Menu Button Navigation Menubar
`option`	-	Editable Combobox With Both List and Inline Autocomplete Editable Combobox With List Autocomplete Editable Combobox without Autocomplete
`presentation`	Intentionally Hiding Semantics with the presentation Role Effects of Role presentation Conditions That Cause Role presentation to be Ignored Example Demonstrating Effects of the presentation Role	-
`radio`	Radio Group For Radio Groups Not Contained in a Toolbar For Radio Group Contained in a Toolbar	Radio Group Using Roving tabindex Radio Group Using aria-activedescendant Toolbar
`radiogroup`	-	Radio Group Using Roving tabindex Radio Group Using aria-activedescendant Toolbar
`region`	Region	Accordion Auto-Rotating Image Carousel Region Landmark
`row`	-	Editable Combobox with Grid Popup Layout Grid Table Treegrid Email Inbox
`slider`	Slider Slider (Multi-Thumb)	Horizontal Multi-Thumb Slider Horizontal Slider Slider with aria-orientation and aria-valuetext
`spinbutton`	Spinbutton	Date Picker Spin Button Toolbar
`tab`	Keyboard Navigation Between Components (The Tab Sequence)	Tabs with Automatic Activation Tabs with Manual Activation
`table`	Grid and Table Properties Table	Table
`tablist`	-	Tabs with Automatic Activation Tabs with Manual Activation
`tabpanel`	-	Tabs with Automatic Activation Tabs with Manual Activation
`toolbar`	Toolbar For Radio Groups Not Contained in a Toolbar For Radio Group Contained in a Toolbar	Toolbar
`tree`	Tree View Tree Popup Keyboard Interaction	File Directory Treeview Using Computed Properties File Directory Treeview Using Declared Properties Navigation Treeview Using Computed Properties Navigation Treeview Using Declared Properties
`treeitem`	-	File Directory Treeview Using Computed Properties File Directory Treeview Using Declared Properties Navigation Treeview Using Computed Properties Navigation Treeview Using Declared Properties

Properties and States with No Guidance or Examples (14)

aria-atomic
aria-details
aria-dropeffect
aria-errormessage
aria-flowto
aria-grabbed
aria-invalid
aria-keyshortcuts
aria-multiline
aria-owns
aria-placeholder
aria-readonly
aria-relevant
aria-required

Properties and States with at Least One Guidance or Example (9)

Property or State	Guidance	Example
`aria-busy`	-	Feed
`aria-colcount`	Using aria-colcount and aria-colindex	Data Grid
`aria-colspan`	Defining cell spans using aria-colspan and aria-rowspan	-
`aria-current`	-	Disclosure for Navigation Menus
`aria-multiselectable`	-	Listboxes with Rearrangeable Options
`aria-orientation`	-	Slider with aria-orientation and aria-valuetext
`aria-roledescription`	-	Auto-Rotating Image Carousel
`aria-rowspan`	Defining cell spans using aria-colspan and aria-rowspan	-
`aria-sort`	Indicating sort order with aria-sort	Data Grid

Properties and States with More than One Guidance or Example (25)

Property or State	Guidance	Examples
`aria-activedescendant`	Managing Focus in Composites Using aria-activedescendant	Editable Combobox With Both List and Inline Autocomplete Editable Combobox With List Autocomplete Editable Combobox without Autocomplete Editable Combobox with Grid Popup Collapsible Dropdown Listbox Listbox with Grouped Options Listboxes with Rearrangeable Options Scrollable Listbox Actions Menu Button Using aria-activedescendant Radio Group Using aria-activedescendant
`aria-autocomplete`	-	Editable Combobox With Both List and Inline Autocomplete Editable Combobox With List Autocomplete Editable Combobox without Autocomplete Editable Combobox with Grid Popup
`aria-checked`	-	Checkbox (Two State) Checkbox (Mixed-State) Editor Menubar Radio Group Using Roving tabindex Radio Group Using aria-activedescendant Toolbar
`aria-colindex`	Using aria-colcount and aria-colindex Using aria-colindex When Column Indices Are Contiguous Using aria-colindex When Column Indices Are Not Contiguous	-
`aria-controls`	-	Accordion Checkbox (Mixed-State) Editable Combobox With Both List and Inline Autocomplete Editable Combobox With List Autocomplete Editable Combobox without Autocomplete Editable Combobox with Grid Popup Disclosure (Show/Hide) for Answers to Frequently Asked Questions Disclosure (Show/Hide) for Image Description Disclosure for Navigation Menus Actions Menu Button Using aria-activedescendant Actions Menu Button Using element.focus() Navigation Menu Button Tabs with Automatic Activation Tabs with Manual Activation Toolbar
`aria-describedby`	Describing by referencing content with aria-describedby	Alert Dialog Modal Dialog Feed Table
`aria-disabled`	-	Accordion Editor Menubar Toolbar
`aria-expanded`	-	Accordion Editable Combobox With Both List and Inline Autocomplete Editable Combobox With List Autocomplete Editable Combobox without Autocomplete Editable Combobox with Grid Popup Disclosure (Show/Hide) for Answers to Frequently Asked Questions Disclosure (Show/Hide) for Image Description Disclosure for Navigation Menus Collapsible Dropdown Listbox Actions Menu Button Using aria-activedescendant Actions Menu Button Using element.focus() Navigation Menu Button Navigation Menubar Editor Menubar Toolbar Treegrid Email Inbox File Directory Treeview Using Computed Properties File Directory Treeview Using Declared Properties Navigation Treeview Using Computed Properties Navigation Treeview Using Declared Properties
`aria-haspopup`	-	Editable Combobox with Grid Popup Collapsible Dropdown Listbox Actions Menu Button Using aria-activedescendant Actions Menu Button Using element.focus() Navigation Menu Button Navigation Menubar Editor Menubar Toolbar
`aria-hidden`	-	Alert Dialog Date Picker Spin Button Toolbar
`aria-label`	Naming with a String Attribute Via aria-label	Auto-Rotating Image Carousel Checkbox (Two State) Editable Combobox With Both List and Inline Autocomplete Editable Combobox With List Autocomplete Editable Combobox without Autocomplete Editable Combobox with Grid Popup Alert Dialog Date Picker Dialog Modal Dialog Feed Data Grid Layout Grid Collapsible Dropdown Listbox Listbox with Grouped Options Listboxes with Rearrangeable Options Scrollable Listbox Actions Menu Button Using aria-activedescendant Actions Menu Button Using element.focus() Navigation Menu Button Navigation Menubar Editor Menubar Radio Group Using Roving tabindex Radio Group Using aria-activedescendant Date Picker Spin Button Table Tabs with Automatic Activation Tabs with Manual Activation Toolbar Treegrid Email Inbox File Directory Treeview Using Computed Properties File Directory Treeview Using Declared Properties Navigation Treeview Using Computed Properties Navigation Treeview Using Declared Properties
`aria-labelledby`	Naming with Referenced Content Via aria-labelledby	Checkbox (Two State) Editable Combobox with Grid Popup Alert Dialog Date Picker Dialog Modal Dialog Feed Data Grid Layout Grid Collapsible Dropdown Listbox Listbox with Grouped Options Listboxes with Rearrangeable Options Scrollable Listbox Actions Menu Button Using aria-activedescendant Actions Menu Button Using element.focus() Navigation Menu Button Radio Group Using Roving tabindex Radio Group Using aria-activedescendant Date Picker Spin Button Tabs with Automatic Activation Tabs with Manual Activation File Directory Treeview Using Computed Properties File Directory Treeview Using Declared Properties Navigation Treeview Using Computed Properties Navigation Treeview Using Declared Properties Complementary Landmark Form Landmark Main Landmark Navigation Landmark Region Landmark Search Landmark
`aria-level`	-	Treegrid Email Inbox File Directory Treeview Using Computed Properties File Directory Treeview Using Declared Properties Navigation Treeview Using Declared Properties
`aria-live`	-	Alert Auto-Rotating Image Carousel Date Picker Dialog
`aria-modal`	-	Alert Dialog Date Picker Dialog
`aria-posinset`	-	Feed Treegrid Email Inbox File Directory Treeview Using Computed Properties File Directory Treeview Using Declared Properties Navigation Treeview Using Declared Properties
`aria-pressed`	-	Button (IDL Version) Button Toolbar
`aria-rowcount`	Using aria-rowcount and aria-rowindex	Data Grid Layout Grid
`aria-rowindex`	Using aria-rowcount and aria-rowindex	Data Grid Layout Grid
`aria-selected`	-	Editable Combobox With Both List and Inline Autocomplete Editable Combobox With List Autocomplete Editable Combobox without Autocomplete Editable Combobox with Grid Popup Listboxes with Rearrangeable Options Tabs with Automatic Activation Tabs with Manual Activation
`aria-setsize`	-	Treegrid Email Inbox File Directory Treeview Using Computed Properties File Directory Treeview Using Declared Properties Navigation Treeview Using Declared Properties
`aria-valuemax`	-	Meter Horizontal Multi-Thumb Slider Horizontal Slider Slider with aria-orientation and aria-valuetext Date Picker Spin Button
`aria-valuemin`	-	Meter Horizontal Multi-Thumb Slider Horizontal Slider Slider with aria-orientation and aria-valuetext Date Picker Spin Button Toolbar
`aria-valuenow`	-	Meter Horizontal Multi-Thumb Slider Horizontal Slider Slider with aria-orientation and aria-valuetext Date Picker Spin Button Toolbar
`aria-valuetext`	-	Horizontal Multi-Thumb Slider Slider with aria-orientation and aria-valuetext Date Picker Spin Button Toolbar