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 |