commit b107fb0aa976428b4427550da261bcc03a7782cf Author: Alexander Surkov Date: Fri Jul 19 14:10:01 2013 -0400 Bug 12703 - Review/Modify/Add IA2 and ATK role mapping for elements diff --git a/css/extra.css b/css/extra.css index 8d7ea3c..cbce9fd 100644 --- a/css/extra.css +++ b/css/extra.css @@ -44,4 +44,13 @@ summary:hover, summary:focus, details[open] summary:hover, details[open] summary .show-hide-cols button {background-color: #ddd; font-size: 80%; margin: 0 5px; padding-right: 15px;} .show-hide-cols .action {position: absolute; left: -9999em;} .show-col {background: url(../img/cross.png) no-repeat right center;} -.hide-col {background: url(../img/tick.png) no-repeat right center;} \ No newline at end of file +.hide-col {background: url(../img/tick.png) no-repeat right center;} + +.general, .role, .states, .actions, .objattrs, .textattrs, .relations { + margin-top: 6px; + margin-bottom: 6px; +} + +.type { + font-weight: bold; +} \ No newline at end of file diff --git a/index.html b/index.html index 27df853..f3b93ad 100644 --- a/index.html +++ b/index.html @@ -102,7 +102,19 @@ Yes link role ROLE_SYSTEM_LINK. Also, apply special rule to expose STATE_LINKED to link and all its descendants.

Use MSAA or UIA guidance - ROLE_SYSTEM_LINK. Also, apply special rule to expose STATE_LINKED to link and all its descendants. + +
+ Role: ROLE_SYSTEM_LINK +
+
+ States: + STATE_SYSTEM_LINKED to link and all its descendants. If link is visited then STATE_SYSTEM_TRAVERSED. +
+
+ Actions: + "jump" action on link and all its descendants. +
+ HyperLink ROLE_LINK AXLink
(null)
link @@ -113,7 +125,12 @@ Yes none ROLE_SYSTEM_TEXT

Use MSAA or UIA guidance - ROLE_SYSTEM_TEXT + +
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_TEXT_FRAME +
+ Text ROLE_TEXT AXGroup
(null)
group @@ -124,7 +141,17 @@ Yes none ROLE_SYSTEM_TEXT

Use MSAA or UIA guidance - IA2_ROLE_TEXT_FRAME + +
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_TEXT_FRAME +
+
+ Object attributes: + "abbr" attribute on the containing HTML td if a single child, + text content used as a value +
+ Text

ROLE_TEXT

Object attribute role="abbr"

@@ -136,8 +163,16 @@ Yes none ROLE_SYSTEM_GROUPING

Use MSAA or UIA guidance -

IA2_ROLE_PARAGRAPH

-

Object attribute role="address"

+ +
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_PARAGRAPH +
+
+ Object attributes: + "xml-roles: address" +
+ Group

ROLE_PARAGRAPH

Object attribute role="address"

@@ -149,7 +184,16 @@ Yes link role ROLE_SYSTEM_LINK. Also, apply special rule to expose STATE_LINKED to link and all its descendants.

Use MSAA or UIA guidance - ROLE_SYSTEM_LINK. Also, apply special rule to expose STATE_LINKED to link and all its descendants. + +
+ Role: + ROLE_SYSTEM_LINK exposed as a child of connected HTML:img element +
+
+ States: + STATE_LINKED +
+ HyperLink ROLE_LINK AXLink
(null)
link @@ -160,7 +204,12 @@ Yes none ROLE_SYSTEM_TEXT

Use MSAA or UIA guidance - ROLE_SYSTEM_TEXT + +
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_SHAPE +
+ Text ROLE_TEXT Not mapped @@ -171,7 +220,20 @@ Yes article role ROLE_SYSTEM_DOCUMENT + STATE_SYSTEM_READONLY

??ROLE_SYSTEM_GROUPING?

Use MSAA or UIA guidance - ROLE_SYSTEM_DOCUMENT + STATE_SYSTEM_READONLY + +
+ Role: + ROLE_SYSTEM_DOCUMENT +
+
+ States: + STATE_SYSTEM_READONLY +
+
+ Object attributes: + "xml-roles: article" +
+ ??Group or Text?? ROLE_DOCUMENT_FRAME + do not expose STATE_EDITABLE AXGroup
AXDocumentArticle
article @@ -182,7 +244,16 @@ Yes complementary role ROLE_SYSTEM_GROUPING

Use MSAA or UIA guidance - IA2_ROLE_COMPLEMENTARY_CONTENT

Object attribute role="complementary" + +
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_NOTE +
+
+ Object attributes: + "xml-roles: complementary" +
+ Group ROLE_SECTION

Object attribute role="complementary" AXGroup
AXLandmarkComplementary
complementary @@ -193,7 +264,12 @@ Yes none ROLE_SYSTEM_GROUPING

? - ROLE_SYSTEM_GROUPING + +
+ Role: + ROLE_SYSTEM_GROUPING +
+ Group ROLE_PANEL

AXGroup
(null)
group

Note: UI controls within the audio element exposed as AXToolbar.

@@ -204,7 +280,12 @@ Yes none ROLE_SYSTEM_TEXT

Use MSAA or UIA guidance - ROLE_SYSTEM_TEXT + +
Doesn't have an accessible, exposed as + "font-weight" text attribute on the text container. + The value depends on the platform. +
+ Text ROLE_TEXT AXGroup
(null)
group @@ -215,7 +296,9 @@ Yes none Not mapped

Not mapped - Not mapped + +
Not mapped
+ Not mapped Not mapped Not mapped @@ -226,7 +309,11 @@ none - + +
Doesn't have an accessible. May affect on + "writing-mode" text attribute on the text container. +
+ @@ -237,7 +324,11 @@ Yes none ROLE_SYSTEM_TEXT

Use MSAA or UIA guidance - ROLE_SYSTEM_TEXT + +
Doesn't have an accessible. + Exposed as "writing-mode" text attribute on the text container. +
+ text ROLE_TEXT AXGroup
(null)
group @@ -248,7 +339,12 @@ Yes none ROLE_SYSTEM_GROUPING

Use MSAA or UIA guidance - IA2_ROLE_SECTION + +
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_SECTION +
+ Group ROLE_SECTION  AXGroup
(null)
group @@ -259,7 +355,12 @@ Yes document role ROLE_SYSTEM_DOCUMENT + STATE_SYSTEM_READONLY

Use MSAA or UIA guidance - ROLE_SYSTEM_DOCUMENT + STATE_SYSTEM_READONLY + +
+ Doesn't have an accessible. All DOM attributes are + proccessed as they belonged to its document accessible. +
+ Document ROLE_DOCUMENT_FRAME + STATE_READONLY AXGroup
(null)
group @@ -270,7 +371,12 @@ Yes none ROLE_SYSTEM_ WHITESPACE

? - ROLE_SYSTEM_ WHITESPACE + +
+ Role: + ROLE_SYSTEM_WHITESPACE +
+ ? ? Not mapped @@ -281,7 +387,19 @@ Yes button role ROLE_SYSTEM_PUSHBUTTON.

Use MSAA or UIA guidance - ROLE_SYSTEM_PUSHBUTTON + +
+ Role: + ROLE_SYSTEM_PUSHBUTTON +
+
+ States: + STATE_SYSTEM_DEFAULT if the button is default +
+
+ Actions: "press" +
+ Button

?? When it is in a <menu> it defines a command.  Is it still a button, or is it a menuitem?? ROLE_PUSH_BUTTON AXButton
(null)
button @@ -292,7 +410,12 @@ Yes none SYSTEM_ROLE_GRAPHIC

Use MSAA or UIA guidance - IA2_ROLE_CANVAS + +
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_CANVAS +
+ Image

NOTE: subdom elements will be mapped separately ROLE_CANVAS AXImage
(null)
image @@ -303,7 +426,16 @@ Yes none ROLE_SYSTEM_TEXT
+ STATE_SYSTEM_READONLY

Use MSAA or UIA guidance - IA2_ROLE_CAPTION + +
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_CAPTION +
+
+ Relations: + RELATION_LABELLED_BY / RELATION_LABEL_FOR with containing HTML table accessible +
+ text
The parent table has a UIA_LabeledByPropertyId pointing to the UIA element for the caption element. ROLE_CAPTION AXGroup
(null)
group @@ -314,7 +446,12 @@ Yes none ROLE_SYSTEM_TEXT

??GROUP??

text - ROLE_SYSTEM_TEXT + +
+ Doesn't have an accessible. Default styles are + mapped into text attributes on the text container. +
+ text
??group?? ROLE_TEXT AXGroup
(null)
group @@ -325,7 +462,12 @@ Yes none ROLE_SYSTEM_TEXT

text - ROLE_SYSTEM_TEXT + +
+ Doesn't have an accessible. Default styles are + mapped into text attributes on the text container. +
+ text ROLE_TEXT AXGroup
(null)
group @@ -336,7 +478,9 @@ Yes none ?ROLE_SYSTEM_COLUMN - not mapped + +
Not mapped
+ ? not mapped Not mapped @@ -347,7 +491,9 @@ Yes none ?ROLE_SYSTEM_GROUPING

?TODO:  look in more detail at UIA table implemenation - not mapped + +
Not mapped
+ ?TODO:  look in more detail at UIA table implemenation not mapped Not mapped @@ -391,7 +537,9 @@ - + +
Not mapped
+ @@ -402,7 +550,15 @@ Yes listbox role, with the aria-multiselectable property set to "false" ROLE_SYSTEM_COMBOBOX + STATE_SYSTEM_HASPOPUP.

Use UIA guidance - ROLE_SYSTEM_COMBOBOX + STATE_SYSTEM_HASPOPUP. + +
+ Used to constact a list of options for autocompletes (in other words it might not accessible itself) +
+
+ Role: + ROLE_SYSTEM_LIST +
+ Combobox ROLE_COMBO_BOX + STATE_EXPANDABLE AXComboBox
(null)
combo box @@ -413,7 +569,12 @@ Yes none ROLE_SYSTEM_TEXT

? - IA2_ROLE_PARAGRAPH + +
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_PARAGRAPH +
+ ? ROLE_TEXT AXGroup
AXDefinition
definition @@ -424,7 +585,12 @@ Yes none ROLE_SYSTEM_TEXT

? - ROLE_SYSTEM_TEXT + +
+ Doesn't have an accessible. Default styles are mapped + into text attributes on the text container. +
+ ? ROLE_TEXT AXGroup
(null)
group @@ -435,7 +601,12 @@ Yes none
??dialog seems closer?? ROLE_SYSTEM_GROUPING

  - ROLE_SYSTEM_GROUPING + +
+ Role: + ROLE_SYSTEM_GROUPING +
+ Group
??window?? ROLE_PANEL ? @@ -446,7 +617,12 @@ Yes none ROLE_SYSTEM_TEXT

  - ROLE_SYSTEM_TEXT + +
+ Doesn't have an accessible. Default styles are + exposed by text attributes on the text container. +
+ ? ROLE_TEXT AXGroup
(null)
group @@ -457,7 +633,12 @@ - + +
+ Role: + ROLE_SYSTEM_DIALOG +
+ @@ -468,7 +649,15 @@ Yes none ROLE_SYSTEM_GROUPING

  - IA2_ROLE_SECTION + +
+ May not have an accessible if has no semantic meaning. Otherwise +
+
+ Role: + tag name BSTR (MSAA) and IA2_ROLE_SECTION +
+ ? ROLE_SECTION AXGroup
(null)
group @@ -479,7 +668,16 @@ Yes none ROLE_SYSTEM_LIST + STATE_SYSTEM_READONLY

Use MSAA or UIA guidance - ROLE_SYSTEM_LIST + STATE_SYSTEM_READONLY + +
+ Role: + ROLE_SYSTEM_LIST +
+
+ States: + STATE_SYSTEM_READONLY +
+ List ROLE_LIST + do not expose STATE_EDITABLE AXList
AXDefinitionList
definition list @@ -490,7 +688,16 @@ Yes none ROLE_SYSTEM_LISTITEM + STATE_SYSTEM_READONLY

  - ROLE_SYSTEM_LISTITEM + STATE_SYSTEM_READONLY + +
+ Role: + ROLE_SYSTEM_LISTITEM +
+
+ States: + STATE_SYSTEM_READONLY +
+ ListItem ROLE_LISTITEM + do not expose STATE_EDITABLE AXGroup
AXTerm
term