From 263e75921326fbe4d47a246c53fac4d047ff78fe Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Mon, 16 Dec 2019 19:00:03 -0500 Subject: [PATCH] spec cleanup / link updates related to #195 --- html-aam/index.html | 551 +++++++++++++++++++++++--------------------- 1 file changed, 288 insertions(+), 263 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 38de9d603..15bbed2a1 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -456,12 +456,18 @@

HTML Element Role Mappings

-
- Control Type: Group -
-
Localized Control Type: "audio"
-
Note: If the controls attribute is present, UI controls (e.g. play, volume) are exposed as children of the audio element in the accessibility tree, and mapped as appropriate for the type of control (e.g. button or slider).
-
Text objects associated with loading or error messages, and any UI control not currently displayed, MAY be present in the accessibility tree and marked as hidden or off-screen.
+
+ Control Type: `Group` +
+
+ Localized Control Type: `"audio"` +
+
+ Note: If the `controls` attribute is present, UI controls (e.g. play, volume) are exposed as children of the `audio` element in the accessibility tree, and mapped as appropriate for the type of control (e.g. `button` or `slider`). +
+
+ Text objects associated with loading or error messages, and any UI control not currently displayed, MAY be present in the accessibility tree and marked as hidden or off-screen. +
@@ -479,7 +485,7 @@

HTML Element Role Mappings

AXRoleDescription: `"audio playback"`
- Note: If the `controls` attribute is present, UI controls (e.g. play, volume) are exposed as descendants of an accessible object with a role of `toolbar`, and mapped as appropriate for the type of control (e.g. `button` or `slider`). + Note: If the `controls` attribute is present, UI controls (e.g. play, volume) are exposed as descendants of an accessible object with a role of `toolbar`, and mapped as appropriate for the type of control (e.g. `button` or `slider`).
@@ -599,47 +605,47 @@

HTML Element Role Mappings

- - `blockquote` - - No corresponding role - -
- Roles: ROLE_SYSTEM_GROUPING; IA2_ROLE_SECTION -
-
- Interfaces: - IAccessibleText2; IAccessibleHypertext2; -
- - -
- Control Type: Group -
-
Localized Control Type: "blockquote"
- - -
- Role: - ATK_ROLE_BLOCK_QUOTE -
-
- Interfaces: - AtkText; AtkHypertext -
- - -
- AXRole: AXGroup -
-
- AXSubrole: (nil) -
-
- AXRoleDescription: "group" -
- - + + `blockquote` + + No corresponding role + +
+ Roles: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION` +
+
+ Interfaces: + `IAccessibleText2`; `IAccessibleHypertext2`; +
+ + +
+ Control Type: `Group` +
+
+ Localized Control Type: `"blockquote"` +
+ + +
+ Role: `ATK_ROLE_BLOCK_QUOTE` +
+
+ Interfaces: `AtkText`; `AtkHypertext` +
+ + +
+ AXRole: `AXGroup` +
+
+ AXSubrole: `(nil)` +
+
+ AXRoleDescription: `"group"` +
+ + @@ -678,28 +684,30 @@

HTML Element Role Mappings

- `br` - No corresponding role - -
No accessible object. Exposed as '\n' character - via IAccessibleText2 interface on the text container. -
- -
Not mapped
- -
No accessible object. Exposed as '\n' character - via AtkText interface on the text container. -
- -
Not mapped
- + `br` + No corresponding role + +
+ No accessible object. Exposed as '\n' character + via `IAccessibleText2` interface on the text container. +
+ +
Not mapped
+ +
+ No accessible object. Exposed as '\n' character + via `AtkText` interface on the text container. +
+ +
Not mapped
+ `button` - button role + `button` role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -708,41 +716,40 @@

HTML Element Role Mappings

- - `canvas` - - No corresponding role - -
- Roles: ROLE_SYSTEM_GRAPHIC; IA2_ROLE_CANVAS -
- - -
- Control Type: Image -
-
- Descendants of the canvas element are mapped separately. -
- - -
- Role: - ATK_ROLE_CANVAS -
- - -
- AXRole: AXGroup -
-
- AXSubrole: (nil) -
-
- AXRoleDescription: "" -
- - + + `canvas` + + No corresponding role + +
+ Roles: `ROLE_SYSTEM_GRAPHIC`; `IA2_ROLE_CANVAS` +
+ + +
+ Control Type: `Image` +
+
+ Descendants of the `canvas` element are mapped separately. +
+ + +
+ Role: `ATK_ROLE_CANVAS` +
+ + +
+ AXRole: `AXGroup` +
+
+ AXSubrole: `(nil)` +
+
+ AXRoleDescription: `""` +
+ + @@ -769,7 +776,7 @@

HTML Element Role Mappings

Control Type: `Text`
- Other properties: The `LabeledBy` property for the parent `table` element points to the UIA element for the `caption` element + Other properties: The `LabeledBy` property for the parent `table` element points to the UIA element for the `caption` element.
@@ -902,7 +909,7 @@

HTML Element Role Mappings

`data` - + No corresponding role
Not mapped
Not mapped
Not mapped
@@ -960,7 +967,7 @@

HTML Element Role Mappings

Role: `ATK_ROLE_CONTENT_DELETION`
- Object attributes: xml-roles:deletion + Object attributes: `xml-roles:deletion`
@@ -1053,37 +1060,38 @@

HTML Element Role Mappings

May not have an accessible object if has no semantic meaning. Otherwise,
- Roles: ROLE_SYSTEM_GROUPING; IA2_ROLE_SECTION + Roles: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION`
- Interfaces: - IAccessibleText2; IAccessibleHypertext2; + Interfaces: + `IAccessibleText2`; `IAccessibleHypertext2`;
-
Control Type: Group
+
+ Control Type: `Group` +
May not have an accessible object if has no semantic meaning. Otherwise,
- Role: - ATK_ROLE_SECTION + Role: `ATK_ROLE_SECTION`
- Interfaces: AtkText; AtkHypertext + Interfaces: `AtkText`; `AtkHypertext`
- AXRole: AXGroup + AXRole: `AXGroup`
- AXSubrole: (nil) + AXSubrole: `(nil)`
- AXRoleDescription: "group" + AXRoleDescription: `"group"`
@@ -1095,31 +1103,31 @@

HTML Element Role Mappings

No corresponding role
- Role: ROLE_SYSTEM_LIST + Role: `ROLE_SYSTEM_LIST`
- States: STATE_SYSTEM_READONLY + States: `STATE_SYSTEM_READONLY`
- Control Type: List + Control Type: `List`
- Role: ATK_ROLE_DESCRIPTION_LIST + Role: `ATK_ROLE_DESCRIPTION_LIST`
- AXRole: AXList + AXRole: `AXList`
- AXSubrole: AXDefinitionList + AXSubrole: `AXDefinitionList`
- AXRoleDescription: "definition list" + AXRoleDescription: `"definition list"`
@@ -1462,76 +1470,85 @@

HTML Element Role Mappings

- h1, h2, h3, h4, h5, h6 - heading role, with the aria-level property set to the number in the element's tag name. -
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
- + + `h1`, `h2`, `h3`, `h4`, `h5`, and `h6` + + + `heading` role, with the `aria-level` property set to the number in the element's tag name. + +
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+ - head - No corresponding role -
Not mapped
-
Not mapped
-
Not mapped
-
Not mapped
- + `head` + No corresponding role +
Not mapped
+
Not mapped
+
Not mapped
+
Not mapped
+ - header (scoped to the body element) - banner role -
Use WAI-ARIA mapping
- -
Use WAI-ARIA mapping
-
Localized Control Type: "header"
- -
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
- + + `header` (scoped to the `body` element) + + + `banner` role + +
Use WAI-ARIA mapping
+ +
Use WAI-ARIA mapping
+
Localized Control Type: `"header"`
+ +
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+ - header (scoped to the main element, a sectioning content element, or a sectioning root element other than body) - No corresponding role - -
- Role: ROLE_SYSTEM_GROUPING; IA2_ROLE_SECTION -
-
- Interfaces: IAccessibleText2; IAccessibleHypertext2; -
- - -
- Control Type: Group -
-
- Localized Control Type: "header" -
- - -
- Role: - ATK_ROLE_HEADER -
-
- Interfaces: - AtkText; AtkHypertext -
- - -
- AXRole: AXGroup -
-
- AXSubrole: (nil) -
-
- AXRoleDescription: "group" -
- - + + `header` (scoped to the `main` element, a sectioning content element, or a sectioning root element other than `body`) + + No corresponding role + +
+ Role: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION` +
+
+ Interfaces: + `IAccessibleText2`; `IAccessibleHypertext2`; +
+ + +
+ Control Type: `Group` +
+
+ Localized Control Type: `"header"` +
+ + +
+ Role: `ATK_ROLE_HEADER` +
+
+ Interfaces: `AtkText`; `AtkHypertext` +
+ + +
+ AXRole: `AXGroup` +
+
+ AXSubrole: `(nil)` +
+
+ AXRoleDescription: `"group"` +
+ + @@ -1603,41 +1620,40 @@

HTML Element Role Mappings

`iframe` - No corresponding role - -
- Role: IA2_ROLE_INTERNAL_FRAME -
- - -
- Control Type: Pane -
- - -
- Role: - ATK_ROLE_INTERNAL_FRAME -
- - -
- AXRole: AXWebArea -
-
- AXSubrole: (nil) -
-
- AXRoleDescription: "html content" -
- - + No corresponding role + +
+ Role: `IA2_ROLE_INTERNAL_FRAME` +
+ + +
+ Control Type: `Pane` +
+ + +
+ Role: `ATK_ROLE_INTERNAL_FRAME` +
+ + +
+ AXRole: `AXWebArea` +
+
+ AXSubrole: `(nil)` +
+
+ AXRoleDescription: `"html content"` +
+ + `img` - img role + `img` role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -1645,28 +1661,38 @@

HTML Element Role Mappings

- img (alt attribute value is an empty string, i.e. alt="" or alt with no value in the markup) - -
presentation
-
See also the Note under img element Accessible Name Computation.
- -
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
- + + `img` (`alt` attribute value is an empty string, i.e. `alt=""` or `alt` with no value in the markup) + + +
+ `presentation` +
+
+ See also the Note under `img` element Accessible Name Computation. +
+ +
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+ - input (type attribute in the Button state) - button role -
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
-
Use WAI-ARIA mapping
- + + `input` (`type` attribute in the Button state) + + + `button` role + +
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+
Use WAI-ARIA mapping
+ - input (type attribute in the Checkbox state) + `input` (type attribute in the Checkbox state) checkbox role, with the aria-checked state set to "mixed" if the element's indeterminate IDL attribute is true, or "true" if the element's checkedness is true, or "false" otherwise
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -1675,7 +1701,7 @@

HTML Element Role Mappings

- input (type attribute in the Color state) + `input` (type attribute in the Color state) No corresponding role
If implemented as a textbox:
@@ -1718,7 +1744,7 @@

HTML Element Role Mappings

- input (type attribute in the Date state) + `input` (type attribute in the Date state) No corresponding role @@ -1758,7 +1784,7 @@

HTML Element Role Mappings

- input (type attribute in the E-mail state with no suggestions source element) + `input` (type attribute in the E-mail state with no suggestions source element) textbox role
Use WAI-ARIA mapping
@@ -1807,7 +1833,7 @@

HTML Element Role Mappings

- input (type attribute in the File Upload state) + `input` (type attribute in the File Upload state) No corresponding role
@@ -1856,7 +1882,7 @@

HTML Element Role Mappings

- input (type attribute in the Hidden state) + `input` (type attribute in the Hidden state) No corresponding role
Not mapped
Not mapped
@@ -1865,7 +1891,7 @@

HTML Element Role Mappings

- input (type attribute in the Image Button state) + `input` (type attribute in the Image Button state) button role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -1874,7 +1900,7 @@

HTML Element Role Mappings

- input (type attribute in the Local Date and Time state) + `input` (type attribute in the Local Date and Time state) No corresponding role
@@ -1906,7 +1932,7 @@

HTML Element Role Mappings

- input (type attribute in the Month state) + `input` (type attribute in the Month state) No corresponding role
@@ -1938,7 +1964,7 @@

HTML Element Role Mappings

- input (type attribute in the Number state) + `input` (type attribute in the Number state) spinbutton role
@@ -1976,7 +2002,7 @@

HTML Element Role Mappings

- input (type attribute in the Password state) + `input` (type attribute in the Password state) No corresponding role
Role: ROLE_SYSTEM_TEXT
@@ -2006,7 +2032,7 @@

HTML Element Role Mappings

- input (type attribute in the Radio Button state) + `input` (type attribute in the Radio Button state) radio role, with the aria-checked state set to "true" if the element's checkedness is true, or "false" otherwise. With aria-setsize value reflecting number of type=radio input elements within the radio button group and aria-posinset value reflecting the elements position within the radio button group.
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -2015,7 +2041,7 @@

HTML Element Role Mappings

- input (type attribute in the Range state) + `input` (type attribute in the Range state) slider role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -2024,7 +2050,7 @@

HTML Element Role Mappings

- input (type attribute in the Reset Button state) + `input` (type attribute in the Reset Button state) button role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -2033,7 +2059,7 @@

HTML Element Role Mappings

- input (type attribute in the Search state with no suggestions source element) + `input` (type attribute in the Search state with no suggestions source element) searchbox role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -2042,7 +2068,7 @@

HTML Element Role Mappings

- input (type attribute in the Submit Button state) + `input` (type attribute in the Submit Button state) button role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -2051,7 +2077,7 @@

HTML Element Role Mappings

- input (type attribute in the Telephone state with no suggestions source element) + `input` (type attribute in the Telephone state with no suggestions source element) textbox role
Use WAI-ARIA mapping
@@ -2066,7 +2092,7 @@

HTML Element Role Mappings

- input (type attribute in the Text state with no suggestions source element) + `input` (type attribute in the Text state with no suggestions source element) textbox role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
@@ -2075,7 +2101,7 @@

HTML Element Role Mappings

- input (type attribute in the Text, Search, Telephone, URL, or E-mail states with a suggestions source element) + `input` (type attribute in the Text, Search, Telephone, URL, or E-mail states with a suggestions source element) combobox role, with the aria-owns property set to the same value as the list attribute
Use WAI-ARIA mapping
Object attributes: text-input-type:as per input type
@@ -2090,7 +2116,7 @@

HTML Element Role Mappings

- input (type attribute in the Time state) + `input` (type attribute in the Time state) No corresponding role
@@ -2126,7 +2152,7 @@

HTML Element Role Mappings

- input (type attribute in the URL state with no suggestions source element) + `input` (type attribute in the URL state with no suggestions source element) textbox role
Use WAI-ARIA mapping
@@ -2143,36 +2169,35 @@

HTML Element Role Mappings

- input (type attribute in the Week state) + `input` (type attribute in the Week state) No corresponding role
- Role: IA2_ROLE_DATE_EDITOR + Role: `IA2_ROLE_DATE_EDITOR`
- Object attributes: text-input-type:week + Object attributes: `text-input-type:week`
-
- Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners. -
+
+ Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners. +
- Role: - ATK_ROLE_CALENDAR + Role: `ATK_ROLE_CALENDAR`
- AXRole: AXTextField + AXRole: `AXTextField`
- AXSubrole: (nil) + AXSubrole: `(nil)`
- AXRoleDescription: "text field" + AXRoleDescription: `"text field"`