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.

HTML

UI Automation

Element (Ancestor)

Properties

Control type

Supported control patterns

Properties

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"

THTHEAD

(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

-TABINDEX

Not 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"

Mapping HTML and ARIA properties to UI Automation

UI Automation