Mapping HTML 4.0 to UI Automation
Collapse the table of content
Expand the table of content

Mapping HTML 4.0 to UI Automation

[This article is for Windows 8.x and Windows Phone 8.x developers writing Windows Runtime apps. If you’re developing for Windows 10, see the latest documentation]

The table in this section shows how HTML 4.0 elements and properties map to Microsoft UI Automation control types, control patterns, and properties. The following notes pertain to the table:

  • Plain text in a BODY element maps to the Text control type; however, the bounding rectangle of a BODY element includes the immediately preceding non-textual element, if any.
  • Because all elements in the following table support the LegacyIAccessible control pattern, this pattern is included in the table only when it exposes information that isn't exposed through any other property.
  • A hyphen (-) indicates a property that must be excluded (or the property's value must be empty). A plus sign (+) indicates that a value for the property is required.

HTMLUI Automation
Element (Ancestor)PropertiesControl typeSupported control patternsProperties
A -HREF Hyperlink

Invoke,

Scroll,

ScrollItem,

TextChild,

Value

Name="The text enclosed by the element's tags"

IsEnabled=true

Value.IsReadOnly=true

Value.Value="http://some.website"

A +HREF Hyperlink

Invoke,

Scroll,

ScrollItem,

TextChild,

Value

Name="The text enclosed by the element's tags"

IsEnabled=true

Value.IsReadOnly=true

Value.Value=""

ABBR Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"
ACRONYM Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only"
ADDRESS Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"
APPLET Pane

ScrollItem,

TextChild

Name=""

IsEnabled=true

IsKeyboardFocusable=true

LegacyIAccessible.Description="PLUGIN: type=Embed"

AREA (MAP)-HREF Hyperlink

Invoke,

Scroll,

ScrollItem,

TextChild,

Value

Name="The ALT text"

IsEnabled=true

IsKeyboardFocusable=true

LegacyIAccessible.Description="link region type: CIRCLE"

Value.IsReadOnly=true

Value.Value=""

AREA (MAP)+HREF Hyperlink

Invoke,

Scroll,

ScrollItem,

TextChild,

Value

Name="The ALT text"

IsEnabled=true

IsKeyboardFocusable=true

LegacyIAccessible.Description="link region type: CIRCLE"

Value.IsReadOnly=true

Value.Value="http://some.website"

B Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

BASE (HEAD)Not applicable
BASEFONT {HEAD)Not applicable
BDO Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

BIG Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only"

BLOCKQUOTE Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

BODY Pane

ScrollItem,

TextPattern

Name="The text enclosed by TITLE tags in the HEAD section"

IsEnabled=true

LegacyIAccessible.State="read only"

LegacyIAccessible.Value="file://some/path"

BR Not applicable
BUTTON Button

Invoke,

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

IsKeyboardFocusable=true

CAPTION (TABLE) Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only"

CENTER Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

CITE Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="selected, read only, selectable"

CODE Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

COL (TABLE)Not applicable
COLGROUP (TABLE)Not applicable
DD (DL) ListItem

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="normal"

DEL Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

DFN Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only"

DIR List

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

IsKeyboardFocusable=true

DIV Not applicable
DL ListItem

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="normal"

DT List

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="normal"

EM Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only"

EMBED

TYPE = "application/x-shockwave-flash"

Pane

Name=""

IsEnabled=true

IsKeyboardFocusable=true

ClassName="MacromediaFlashPlayerActiveX"

FIELDSET (FORM)Not applicable
FONT -TABINDEX Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only"

FONT +TABINDEX Text

Scroll,

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="normal"

FONT +TABINDEX, +TITLE Text

Scroll,

ScrollItem,

TextChild

Name="The TITLE text"

IsEnabled=true

LegacyIAccessible.State="normal"

FORM Not applicable
FRAME None Scroll

Name="Full path of the source for the FRAME"

IsEnabled=true

IsKeyboardFocusable=true

Hn (HGROUP) Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

HEAD Not applicable
HR Not applicable
HTML Not applicable
I Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

IFRAME None

Scroll

TextChild

Name="Full path of the source for the IFRAME"

IsEnabled=true

IsKeyboardFocusable=true

IMG -ALT Image

ScrollItem

TextChild

Name=""

IsEnabled=true

LegacyIAccessible.State="normal"

IMG +ALT Image

ScrollItem,

TextChild

Name="The ALT text"

IsEnabled=true

LegacyIAccessible.State="normal"

INPUT TYPE="BUTTON" Button

Invoke,

ScrollItem,

TextChild

Name="The VALUE text"

IsEnabled=true

LegacyIAccessible.State="normal"

INPUT TYPE="CHECKBOX" CheckBox

ScrollItem,

TextChild,

Toggle

Name=""

IsEnabled=true

LegacyIAccessible.State="normal"

Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only"

INPUT TYPE="FILE" Button

Invoke,

ScrollItem,

TextChild

Name=""

IsEnabled=true

IsKeyboardFocusable=true

LegacyIAccessible.Description="Browse…"

Edit

ScrollItem,

TextChild,

Value

Name=""

IsEnabled=true

LegacyIAccessible.Description="Enter name of file to upload"

LegacyIAccessible.State="read only"

Value.IsReadOnly=false

INPUT TYPE="HIDDEN"Not applicable
INPUT TYPE="IMAGE" Button

ScrollItem,

TextChild

Name="The ALT text"

IsEnabled=true

LegacyIAccessible.State="normal"

LegacyIAccessible.Value="Some path"

INPUT TYPE="PASSWORD" Edit

ScrollItem,

TextChild,

Value

Name=""

IsEnabled=true

IsKeyboardFocusable=true

IsPassword=true

LegacyIAccessible.State="focusable, protected"

Value.IsReadOnly=false

INPUT TYPE="RADIO" RadioButton

ScrollItem,

Selection,

SelectionItem,

TextChild

Name=""

IsEnabled=true

LegacyIAccessible.State="normal"

INPUT TYPE="RESET" Button

Invoke,

ScrollItem,

TextChild

Name="The VALUE text"

IsEnabled=true

IsKeyboardFocusable=true

LegacyIAccessible.State="focusable"

INPUT TYPE="SUBMIT" Button

Invoke,

ScrollItem,

TextChild

Name="The VALUE text"

IsEnabled=true

IsKeyboardFocusable=true

LegacyIAccessible.State="default, focusable"

INPUT TYPE="TEXT", -LIST Edit

ScrollItem,

TextChild,

Value

Name=""

IsEnabled=true

IsKeyboardFocusable=true

LegacyIAccessible.State="focusable"

Value.IsReadOnly=false

INS Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

KBD Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

LABEL Text

Scroll,

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="normal"

LEGEND Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

LI (DIR | MENU | OL | UL) ListItem

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="normal"

LINK (HEAD)Not applicable
MAP Not applicable
MENU -TYPE List

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="normal"

META (HEAD)Not applicable
NOFRAMES Not applicable
NOSCRIPT
OBJECT

TYPE = "application/x-silverlight-2"

Window

Name="Silverlight Control"

IsEnabled=true

LegacyIAccessible.State="focusable"

ClassName="MicrosoftSilverlight"

OL List

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

IsKeyboardFocusable=true

OPTGROUP ListItem

SelectionItem

Name="The LABEL text"

IsEnabled=true

LegacyIAccessible.State="normal"

OPTION (SELECT | OPTGROUP | DATALIST) ListItem

Invoke,

SelectionItem

Name="The text enclosed by the element's tags"

IsEnabled=true

IsOffscreen=true

LegacyIAccessible="invisible, selectable"

P Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

PARAM Not applicable
PRE Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

Q Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

S Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

SAMP Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

SCRIPT Not applicable
SELECT +MULTIPLE List

Scroll,

ScrollItem,

Selection,

TextChild

Name=""

IsEnabled=true

LegacyIAccessible.State="normal"

Selection.CanSelectMultiple=false

Selection.IsSelectionRequired=true

SELECT -MULTIPLE ComboBox

ExpandCollapse,

ScrollItem,

TextChild,

Value

Name="The TITLE text"

IsEnabled=true

ExpandCollapse.ExpandCollapseState=Collapsed

Value.IsReadOnly=false

Value.Value="The selected text in the ComboBox"

List

Scroll,

ScrollItem,

Selection,

TextChild

Name="The TITLE text"

IsEnabled=true

IsOffscreen=true

SMALL Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

SPAN Not applicable
STRIKE Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

STRONG Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

STYLE (HEAD )Not applicable
SUB Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only"

SUP Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only"

TABLE Table

Grid,

ScrollItem,

Table,

TextChild

IsEnabled=true

LegacyIAccessible.State="normal"

TBODY Not applicable
TD DataItem

GridItem,

ScrollItem,

TableItem,

TextChild

Name=""

IsEnabled=true

LegacyIAccessible.State="normal"

TEXTAREA Edit

Scroll,

ScrollItem,

TextChild,

Value

Name=""

IsEnabled=true

IsKeyboardFocusable=true

Value.IsReadOnly=false

Value.Value="The text in the TEXTAREA element"

TFOOT Not applicable
TH

(not column/row header)

HeaderItem

GridItem,

ScrollItem,

TextChild

Name=""

IsEnabled=true

LegacyIAccessible.Role="row header"

LegacyIAccessible.State="normal"

TH THEAD

(column header)

HeaderItem

GridItem,

ScrollItem,

TableItem,

TextChild

Name=""

IsEnabled=true

LegacyIAccessible.Role="column header"

LegacyIAccessible.State="normal"

TH

(row header)

HeaderItem

GridItem,

ScrollItem,

TableItem,

TextChild

Name=""

IsEnabled=true

LegacyIAccessible.Role="row header"

LegacyIAccessible.State="normal"

THEAD Not applicable
TITLE (HEAD)Not applicable
TR +TABINDEX Text

Scroll,

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="normal"

TR -TABINDEXNot applicable

TT Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

U Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

UL List

ScrollItem,

TextChild

Name="The text enclosed by the element's tags"

IsEnabled=true

IsKeyboardFocusable=true

VAR Text

Name="The text enclosed by the element's tags"

IsEnabled=true

LegacyIAccessible.State="read only, selectable"

 

Related topics

Mapping HTML and ARIA properties to UI Automation
UI Automation

 

 

Show:
© 2017 Microsoft