Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

HTML To MSAA

Remarks

The table below shows how Gecko maps HTML elements to MSAA. This table reflects mapping rules for specific elements only, it doesn't reflect any general rules applicable to all elements. For example, if name column has n/a value then it means specific elements doesn't provide own rules to calculate name but name can be computed from ARIA markup or @title attribute.

Map

HTML element Role Name Value States Relations Actions Events Notes
a ROLE_SYSTEM_ LINK n/a value of @href attribute

STATE_SYSTEM_ SELECTABLE if @name attribute is presented

STATE_SYSTEM_ LINKED if @href attribute is presented or click event listener is registered

STATE_SYSTEM_ TRAVERSED if link is traversed

n/a "jump" if @href is valid

n/a

 
br ROLE_SYSTEM_ WHITESPACE '\n' (new line char)   STATE_SYSTEM_ READONLY n/a n/a n/a  
button ROLE_SYSTEM_ PUSHBUTTON from child nodes n/a

STATE_SYSTEM_ FOCUSABLE

STATE_SYSTEM_ DEFAULT if @type attribute has value "submit"

n/a "press" n/a  
caption BSTR role n/a n/a n/a

description_for (0x100f), points to table element

     
div BSTR role n/a n/a n/a n/a n/a n/a  
fieldset ROLE_SYSTEM_ GROUPING text equivalent from child legend element n/a n/a labelled_by (1003), points to legend element n/a n/a  
hr ROLE_SYSTEM_ SEPARATOR n/a n/a n/a n/a n/a n/a  
img, input @type=image ROLE_SYSTEM_ GRAPHIC from @alt attribute, empty @alt attribute means name can't be calculated at all n/a STATE_SYSTEM_ ANIMATED if image has more than one frame n/a "showlongdesc" if @longdesc attribute is presented n/a if @usemap attribute is used then image accessible has children for each map item
input @type=button, submit, reset ROLE_SYSTEM_ PUSHBUTTON from @value attribute, @alt attribute, default label, @src attribute, @data attribute n/a STATE_SYSTEM_ DEFAULT if @type attribute has value "submit" n/a "press" n/a  
input @type=text, textarea ROLE_SYSTEM_ TEXT n/a value property of input DOM element  STATE_SYSTEM_ READONLY if @readonly attribute is used n/a "activate" n/a  
input @type=password ROLE_SYSTEM_ TEXT n/a n/a

STATE_SYSTEM_ READONLY if @readonly attribute is used

STATE_SYSTEM_ PROTECTED

n/a "activate" n/a  
input type="checkbox" ROLE_SYSTEM_ CHECKBUTTON n/a n/a

STATE_SYSTEM_ MARQUEED used as state checkable

STATE_SYSTEM_ MIXED for HTML 5 if intermediate property of DOM element returns true

STATE_SYSTEM_ CHECKED if checked property of DOM element returns true

n/a "check"/"uncheck"/"cycle" depending on state EVENT_OBJECT_ STATECHANGE when state is changed  
input type="radio" ROLE_SYSTEM_ RADIOBUTTON n/a n/a

STATE_SYSTEM_ MARQUEED used as state checkable

STATE_SYSTEM_ CHECKED if checked property of DOM element returns true

n/a "select" EVENT_OBJECT_ STATECHANGE when state is changed  
label ROLE_SYSTEM_ STATICTEXT from child nodes n/a n/a n/a n/a n/a  
legend ROLE_SYSTEM_ STATICTEXT n/a n/a n/a label_for (0x1002), points to caption element n/a n/a  
li and others ROLE_SYSTEM_ LISTITEM n/a n/a STATE_SYSTEM_ READONLY n/a n/a n/a contains child accessible for list bullet
ol, ul and others ROLE_SYSTEM_ LIST n/a n/a STATE_SYSTEM_ READONLY n/a n/a n/a  
optgroup BSTR role n/a n/a n/a n/a n/a n/a  
option ROLE_SYSTEM_ LISTITEM from @label attribute, from child text nodes n/a STATE_SYSTEM_ SELECTED if option is selected n/a "select"

EVENT_OBJECT_ SELECTIONWITHIN

EVENT_OBJECT_ SELECTIONADD if selected

EVENT_OBJECT_ SELECTIONREMOVE if unselected

 
select @size > 1 ROLE_SYSTEM_ LIST n/a n/a STATE_SYSTEM_ MULTISELECTABLE if multiselectable n/a n/a n/a  
select @size = 1 ROLE_SYSTEM_ COMBOBOX n/a name of focused option

STATE_SYSTEM_ EXPANDED if combobox open

STATE_SYSTEM_ COLLAPSED if combobox is collapsed

STATE_SYSTEM_ HASPOPUP

STATE_SYSTEM_

FOCUSABLE

n/a "open"/"close" depending on state

EVENT_OBJECT_ VALUECHANGE when selected option is changed

 
table ROLE_SYSTEM_ TABLE from @summary attribute n/a   described_by (0x100e) points to caption element n/a n/a  
td, th ROLE_SYSTEM_ CELL n/a n/a n/a n/a n/a n/a  
thead ROLE_SYSTEM_ COLUMNHEADER n/a n/a n/a

n/a

n/a n/a  
abbr, acronym, blockquote, form, frame, h1-h6, iframe BSTR role n/a n/a n/a n/a n/a n/a  

 

Document Tags and Contributors

Tags: 
 Contributors to this page: Sheppy, Surkov.alexander
 Last updated by: Sheppy,