Mapping ARIA roles to UI Automation

Applies to Windows and Windows Phone

The table in this section shows how Accessible Rich Internet Applications (ARIA) roles map to Microsoft UI Automation control types and control patterns. The following notes pertain to the table:

  • Most HTML elements that are typically invisible in UI Automation become visible if the role attribute is present. The exceptions include INPUT TYPE=hidden, a PARAM hosted in an OBJECT element, and elements in the HEAD section.
  • Although the SCRIPT element is typically invisible in UI Automation, it does appear in the UI Automation tree if the role attribute is present and the element is closed with the </SCRIPT> tag. If the SCRIPTelement has a role attribute but is closed with "/>", the element may or may not appear in the UI Automation tree.
  • The "Control type of visible tags" column identifies the control type that results when you apply the specified role to an HTML element that is typically visible in UI Automation.
  • The "Control type of invisible tags" column identifies the control type that results when you apply the specified role to an HTML element that is typically invisible in UI Automation, such as the DIV or FIELDSET element.
  • "Not applicable" means that the role does not affect how the element maps to UI Automation.
  • If the role attribute exists on an element that is typically mapped to UI Automation as a Text control with no children, the element is mapped as specified in the following table, and the element will contain a Text child element.
  • Because the LegacyIAccessible, ScrollItem and TextChild control patterns are always supported, they are omitted from the following table.
  • If the OPTION element includes any ARIA property, the element is mapped as a Text control instead of a ListItem control.
  • A role attribute can add UI Automation control patterns to the patterns that would be supported by the native HTML tag by itself. Exceptions include the following:
    • TABLE elements lose their Table and Grid control patterns.
    • If a role attribute is associated with a control pattern that is already supported by the HTML tag, the control pattern for the role might override the control pattern for the HTML tag.

ARIAUI Automation
RoleAttributesControl type of visible tagsControl type of invisible tagsSupported control patternsNotes
alertTextText
alertdialogPanePane
applicationPanePane
articleNot applicableText
bannerNot applicableText
buttonButtonButtonInvoke
checkboxCheckBoxCheckBoxToggle
columnheaderHeaderItemHeaderItemGridItem, Invoke, TableItem
comboboxComboBoxComboBoxSelection
combobox+aria-valuetextComboBoxComboBoxSelection, Value
commandGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
complementaryNot applicableText
compositeNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
contentinfoNot applicableText
definitionNot applicableText
dialogPanePane
directoryListList
documentdocumentdocument
formNot applicableText
gridDataGridDataGridGrid
gridcellDataItemDataItemGrid, Invoke
groupGroupGroup
headingTextText
imgImageImage
inputNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
landmarkNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
linkHyperlinkHyperlinkInvoke
link+aria-valuetextHyperlinkHyperlinkInvoke, Value
listListList
listboxListListSelection
listitemDataItemDataItem
logNot applicableText
mainNot applicableText
marqueeTextText
mathNot applicableText
menuMenuMenu
menubarMenuBarMenuBar
menuitemMenuItemMenuItemInvoke
menuitemcheckboxMenuItemMenuItemToggle
menuitemradioMenuItemMenuItem
navigationNot applicableText
noteNot applicableText
optionListItemListItemInvoke
presentationNot applicableNot applicableThis role has no effect on whether an HTML tag is visible in UI Automation.
progressbarProgressBarProgressBar
progressbar+aria-valuenow | aria-valuemax | aria-valueminProgressBarProgressBarRangeValue
radioRadioButtonRadioButton
radiogroupListListSelection
rangeNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
regionPanePane
roletypeNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
rowGroupGroup
rowgroupGroupGroup
rowheaderHeaderItemHeaderItemGridItem, Invoke, TableItem
scrollbarScrollBarScrollBarRangeValue
searchNot applicableText
sectionNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
sectionheadNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
selectNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
separatorSeparatorSeparator
sliderSliderSliderRangeValue
spinbuttonSpinnerSpinnerRangeValue
statusStatusBarStatusBar
structureNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
tabTabItemTabItem
tablistTabTabSelection
tabpanelPanePane
textboxEditEditValue
timerNot applicableText
toolbarToolBarToolBar
tooltipToolTipToolTip
treeTreeTree
treegridDataGridDataGridGrid
treeitemTreeItemTreeItemExpandCollapse, Invoke
widgetNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.
windowNot applicableGroup if DIV, Separator if SPAN, Text otherwiseThe patterns supported by Group, Separator, or TextAbstract role.

 

Related topics

Mapping HTML and ARIA properties to UI Automation
UI Automation

 

 

Show:
© 2014 Microsoft