Skip to content

Commit b801ab7

Browse files
scottaoharascottaohara
authored
Merge branch 'gh-pages' into search-element
2 parents 733cb57 + 9c914b4 commit b801ab7

File tree

1 file changed

+82
-59
lines changed

1 file changed

+82
-59
lines changed

‎index.html

Lines changed: 82 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -402,8 +402,7 @@

HTML Element Role Mappings

402402
<tr tabindex="-1" id="el-aside">
403403
<th>
404404
<a data-cite="HTML">`aside`a>
405-
(scoped to a <a data-cite="HTML/dom.html#sectioning-content">sectioning contenta> element,
406-
or a <a data-cite="HTML/sections.html#sectioning-root">sectioning roota> element other than `body`)
405+
(scoped to a <a data-cite="HTML/dom.html#sectioning-content">sectioning contenta> element)
407406
th>
408407
<td class="aria">
409408
<a class="core-mapping" href="#role-map-complementary">`complementary`a> role if the <a>`aside`a> element has an <a data-cite="accname-1.2/#dfn-accessible-name">accessible namea>.
@@ -1102,8 +1101,7 @@

HTML Element Role Mappings

11021101
<tr tabindex="-1" id="el-footer">
11031102
<th>
11041103
<a data-cite="HTML">`footer`a> (scoped to the <a data-cite="HTML">`main`a> element,
1105-
a <a data-cite="HTML/dom.html#sectioning-content">sectioning contenta> element,
1106-
or a <a data-cite="HTML/sections.html#sectioning-root">sectioning roota> element other than <a data-cite="HTML">`body`a>)
1104+
a <a data-cite="HTML/dom.html#sectioning-content">sectioning contenta> element)
11071105
th>
11081106
<td class="aria">
11091107
<a class="core-mapping" href="#role-map-generic">`generic`a> role
@@ -1204,7 +1202,7 @@

HTML Element Role Mappings

12041202
tr>
12051203
<tr tabindex="-1" id="el-header">
12061204
<th>
1207-
<a data-cite="html">`header`a> (scoped to the <a data-cite="html">`main`a> element, a <a data-cite="html/dom.html#sectioning-content">sectioning contenta> element, or a <a data-cite="html/sections.html#sectioning-root">sectioning roota> element other than <a data-cite="html">`body`a>)
1205+
<a data-cite="html">`header`a> (scoped to the <a data-cite="html">`main`a> element, or a <a data-cite="html/dom.html#sectioning-content">sectioning contenta> element)
12081206
th>
12091207
<td class="aria">
12101208
<a class="core-mapping" href="#role-map-generic">`generic`a> role
@@ -1234,13 +1232,17 @@

HTML Element Role Mappings

12341232
<th>
12351233
<a data-cite="HTML">`hgroup`a>
12361234
th>
1237-
<td class="aria"><a class="core-mapping" href="#role-map-generic">`generic`a> role td>
1235+
<td class="aria"><a class="core-mapping" href="#role-map-group">`group`a> role td>
12381236
<td class="ia2"><div class="general">Use WAI-ARIA mappingdiv>td>
12391237
<td class="uia"><div class="general">Use WAI-ARIA mappingdiv>td>
12401238
<td class="atk"><div class="general">Use WAI-ARIA mappingdiv>td>
12411239
<td class="ax"><div class="general">Use WAI-ARIA mappingdiv>td>
12421240
1243-
<td class="comments">td>
1241+
<td class="comments">
1242+
If an `hgroup` contains multiple heading elements, then the heading element with the highest priority level
1243+
MAY be treated as the sole heading of the `hgroup`. All other heading elements MAY instead be exposed as if they
1244+
were <a href="#el-p">`p`a> elements. See <a class="core-mapping" href="#role-map-paragraph">`paragraph` role on Core AAMa>.
1245+
td>
12441246
tr>
12451247
<tr tabindex="-1" id="el-hr">
12461248
<th>
@@ -2100,26 +2102,38 @@

HTML Element Role Mappings

21002102
<span class="type">Roles:span> `ROLE_SYSTEM_STATICTEXT`; `IA2_ROLE_LABEL`
21012103
div>
21022104
<div class="relations">
2103-
<span class="type">Relations:span> `IA2_RELATION_LABEL_FOR` with a form control that is child to the `label` or referred to by the `label` element's <a href="#att-for-label">`for`a> attribute. The associated form element has `IA2_RELATION_LABELLED_BY` pointing to the `label`.
2105+
<span class="type">Relations:span>
2106+
`IA2_RELATION_LABEL_FOR` with a <a data-cite="html/forms.html#category-label">labelable elementa>
2107+
that is child to the `label` or referred to by the `label` element's <a href="#att-for-label">`for`a> attribute.
2108+
The associated labelable element has `IA2_RELATION_LABELLED_BY` pointing to the `label`.
21042109
div>
21052110
td>
21062111
<td class="uia">
21072112
<div class="ctrltype">
21082113
<span class="type">Control Type:span> `Text`
21092114
div>
2110-
<div class="properties">
2111-
<span class="type">Other properties:span>
2112-
When the `label` element contains an `input` element, the `LabeledBy` property for the `input` element points to the UIA element for the `label` element.
2113-
<p>When the `label` element has a <a href="#att-for-label">`for`a> attribute referencing another element, the `LabeledBy` property for the referenced element points to the UIA element for the `label` element.p>
2115+
<div>
2116+
<span class="type">Relations:span>
2117+
<div>
2118+
When the `label` element contains a <a data-cite="html/forms.html#category-label">labelable elementa>, the `LabeledBy` property for
2119+
the element points to the UIA element for the `label` element.
2120+
div>
2121+
<div>
2122+
When the `label` element has a <a href="#att-for-label">`for`a> attribute referencing a
2123+
<a data-cite="html/forms.html#category-label">labelable elementa>, the `LabeledBy` property for the referenced element points to
2124+
the UIA element for the `label` element.
2125+
div>
21142126
div>
21152127
td>
21162128
<td class="atk">
21172129
<div class="role">
21182130
<span class="type">Role:span> `ATK_ROLE_LABEL`
21192131
div>
21202132
<div class="relations">
2121-
<span class="type">Relations: span>
2122-
`ATK_RELATION_LABEL_FOR` for a child form element or form element referred by <a href="#att-for-label">`for`a> attribute. Note, related form element provides `ATK_RELATION_LABELLED_BY` pointing to the label.
2133+
<span class="type">Relations:span>
2134+
`ATK_RELATION_LABEL_FOR` for a child <a data-cite="html/forms.html#category-label">labelable elementa> or
2135+
labelable element referred by <a href="#att-for-label">`for`a> attribute.
2136+
Note, related labelable element provides `ATK_RELATION_LABELLED_BY` pointing to the `label`.
21232137
div>
21242138
td>
21252139
<td class="ax">
@@ -2406,13 +2420,23 @@

HTML Element Role Mappings

24062420
<tr tabindex="-1" id="el-output">
24072421
<th><a data-cite="HTML">`output`a>th>
24082422
<td class="aria"><a class="core-mapping" href="#role-map-status">`status`a> roletd>
2409-
<td class="ia2"><div class="general">Use WAI-ARIA mappingdiv>td>
2410-
<td class="uia">
2423+
<td class="ia2">
24112424
<div class="general">Use WAI-ARIA mappingdiv>
2412-
<div class="ctrltype"> <span class="type">Localized Control Type:span> `"output"`div>
2425+
<div class="relations">
2426+
<span class="type">Relations:span> `IA2_RELATION_LABELLED_BY` with associated `label` element
2427+
div>
2428+
td>
2429+
<td class="uia"><div class="general">Use WAI-ARIA mappingdiv>td>
2430+
<td class="atk">
2431+
<div class="general">Use WAI-ARIA mappingdiv>
2432+
<div class="relations">
2433+
<span class="type">Relations:span> `ATK_RELATION_LABELLED_BY` with associated `label` element
2434+
div>
2435+
td>
2436+
<td class="ax">
2437+
<div class="general">Use WAI-ARIA mappingdiv>
2438+
<td class="ax">`AXDescription`: value from associated `label` element subtree.td>
24132439
td>
2414-
<td class="atk"><div class="general">Use WAI-ARIA mappingdiv>td>
2415-
<td class="ax"><div class="general">Use WAI-ARIA mappingdiv>td>
24162440
24172441
<td class="comments">td>
24182442
tr>
@@ -2659,33 +2683,13 @@

HTML Element Role Mappings

26592683
tr>
26602684
<tr tabindex="-1" id="el-s">
26612685
<th><a data-cite="HTML">`s`a>th>
2662-
<td class="aria">No corresponding roletd>
2663-
<td class="ia2">
2664-
<div class="general">No accessible object.div>
2665-
<div class="properties">
2666-
<span class="type">Text attributes:span> `text-line-through-style:solid` on the text container
2667-
div>
2668-
td>
2669-
<td class="uia">
2670-
<div class="general">No accessible object. Styles used are exposed by UIA text attribute identifiers of the `TextRange` Control Pattern implemented on a parent accessible object.
2671-
div>
2672-
td>
2673-
<td class="atk">
2674-
<div class="general">No accessible object. Exposed as
2675-
"text-line-through-style:solid" text attribute on the text container.
2676-
div>
2677-
td>
2678-
<td class="ax">
2679-
<div class="role">
2680-
<span class="type">AXRole:span> `AXGroup`
2681-
div>
2682-
<div class="subrole">
2683-
<span class="type">AXSubrole:span> `(nil)`
2684-
div>
2685-
<div class="roledesc">
2686-
<span class="type">AXRoleDescription:span> `"group"`
2687-
div>
2686+
<td class="aria">
2687+
<a class="core-mapping" href="#role-map-deletion">`deletion`a> role
26882688
td>
2689+
<td class="ia2"><div class="general">Use WAI-ARIA mappingdiv>td>
2690+
<td class="uia"><div class="general">Use WAI-ARIA mappingdiv>td>
2691+
<td class="atk"><div class="general">Use WAI-ARIA mappingdiv>td>
2692+
<td class="ax"><div class="general">Use WAI-ARIA mappingdiv>td>
26892693
26902694
<td class="comments">td>
26912695
tr>
@@ -2896,7 +2900,10 @@

HTML Element Role Mappings

28962900
div>
28972901
td>
28982902
2899-
<td class="comments">td>
2903+
<td class="comments">
2904+
If a `summary` element is not a child of a `details` element, or it is not the first `summary` element of a parent `details`,
2905+
then the `summary` element MUST be exposed with a `generic` role.
2906+
td>
29002907
tr>
29012908
<tr tabindex="-1" id="el-sup">
29022909
<th><a data-cite="html">`sup`a>th>
@@ -3566,7 +3573,7 @@

HTML Attribute State and Property Mappings

35663573
<tr tabindex="-1" id="att-checked">
35673574
<th>`checked` (if present)th>
35683575
<td class="elements">
3569-
<a data-cite="html/input.html#attr-input-checked">`input`a>
3576+
<a data-cite="html/input.html#attr-input-checked">`input`a> `type=checkbox` or `type=radio`
35703577
td>
35713578
<td class="aria">
35723579
<a class="core-mapping" href="#ariaCheckedTrue">`aria-checked`a> (state)="true"
@@ -3576,13 +3583,14 @@

HTML Attribute State and Property Mappings

35763583
<td class="atk"><div class="general">Use WAI-ARIA mappingdiv>td>
35773584
<td class="ax">`AXValue: 1`td>
35783585
<td class="comments">
3579-
If the element includes both the `checked` attribute and the `aria-checked` attribute with a valid value, User Agents MUST expose only the `checked` attribute value.
3586+
If an `input` element in the `checkbox` or `radio` state includes both the `checked` attribute and the `aria-checked` attribute with a
3587+
valid value, User Agents MUST expose only the `checked` attribute value.
35803588
td>
35813589
tr>
35823590
<tr tabindex="-1" id="att-checked-absent">
35833591
<th>`checked` (if absent)th>
35843592
<td class="elements">
3585-
<a data-cite="html/input.html#attr-input-checked">`input`a>
3593+
<a data-cite="html/input.html#attr-input-checked">`input`a> `type=checkbox` or `type=radio`
35863594
td>
35873595
<td class="aria">
35883596
<a class="core-mapping" href="#ariaCheckedFalse">`aria-checked`a> (state)="false"
@@ -3592,8 +3600,8 @@

HTML Attribute State and Property Mappings

35923600
<td class="atk"><div class="general">Use WAI-ARIA mappingdiv>td>
35933601
<td class="ax">`AXValue: 0`td>
35943602
<td class="comments">
3595-
An `input` element without a `checked` attribute has an implicit "false" state. User Agents MUST ignore an `aria-checked` attribute
3596-
which conflicts with the native element's implicit checked state.
3603+
An `input` element in the `checkbox` or `radio` state without a `checked` attribute has an implicit "false" state.
3604+
User Agents MUST ignore an `aria-checked` attribute which conflicts with the native element's implicit checked state.
35973605
td>
35983606
tr>
35993607
<tr tabindex="-1" id="att-cite">
@@ -3703,7 +3711,7 @@

HTML Attribute State and Property Mappings

37033711
td>
37043712
<td class="ax">
37053713
<span class="type">Role:span>
3706-
<a href="#el-textarea">AXtextAreaa>
3714+
<a href="#el-textarea">AXTextAreaa>
37073715
<div class="general">Use WAI-ARIA mappingdiv>
37083716
td>
37093717
<td class="comments">
@@ -3963,7 +3971,7 @@

HTML Attribute State and Property Mappings

39633971
<tr tabindex="-1" id="att-for-label">
39643972
<th>`for`th>
39653973
<td class="elements">
3966-
<a href="https://www.w3.org/TR/html/sec-forms.html#element-attrdef-label-for">`label`a>
3974+
<a data-cite="html/forms.html#attr-label-for">`label`a>
39673975
td>
39683976
<td class="aria"><div class="general">Not mappeddiv>td>
39693977
<td class="ia2">
@@ -3973,21 +3981,33 @@

HTML Attribute State and Property Mappings

39733981
<div class="relations">
39743982
<span class="type">Relations: span>
39753983
`IA2_RELATION_LABEL_FOR` and `IA2_RELATION_LABEL_BY` relations between
3976-
<a href="#el-label">`label`a> and referred element
3984+
<a href="#el-label">`label`a> and referred <a data-cite="html/forms.html#category-label">labelable elementa>
3985+
div>
3986+
td>
3987+
<td class="uia">
3988+
<div class="name">
3989+
Used for <a data-cite="accname-1.2/#dfn-accessible-name">accessible namea>
3990+
div>
3991+
<div class="relations">
3992+
When the `label` element has a `for` attribute referencing another <a data-cite="html/forms.html#category-label">labelable elementa>,
3993+
the `LabeledBy` property for the referenced element points to the UIA element for the `label` element.
39773994
div>
39783995
td>
3979-
<td class="uia"><div class="general">Not mappeddiv>td>
39803996
<td class="atk">
39813997
<div class="name">
39823998
Used for <a data-cite="accname-1.2/#dfn-accessible-name">accessible namea>
39833999
div>
39844000
<div class="relations">
39854001
<span class="type">Relations: span>
39864002
`ATK_RELATION_LABEL_FOR` and `ATK_RELATION_LABEL_BY` relations between
3987-
<a href="#el-label">`label`a> and referred element
4003+
<a href="#el-label">`label`a> and referred <a data-cite="html/forms.html#category-label">labelable elementa>
4004+
div>
4005+
td>
4006+
<td class="ax">
4007+
<div class="name">
4008+
Used for <a data-cite="accname-1.2/#dfn-accessible-name">accessible namea>
39884009
div>
39894010
td>
3990-
<td class="ax"><div class="general">Not mappeddiv>td>
39914011
<td class="comments">td>
39924012
tr>
39934013
<tr tabindex="-1" id="att-for-output">
@@ -5859,7 +5879,7 @@

`input type="text"`, `input type="password"`, `input type="number"`, `input

58595879
If the control has an <a data-cite="wai-aria-1.2/#aria-label">`aria-label`a> or an <a data-cite="wai-aria-1.2/#aria-labelledby">`aria-labelledby`a> attribute the <a data-cite="accname-1.2/#dfn-accessible-name">accessible namea> is to be calculated using the algorithm defined in <a href="" class="accname">Accessible Name and Description: Computation and API Mappingsa>.
58605880
li>
58615881
<li>
5862-
Otherwise use the associated `label` element(s) <a data-cite="accname-1.2/#dfn-accessible-name">accessible namea>(s) - if more than one label is associated; concatenate by DOM order, delimited by spaces.
5882+
Otherwise use the associated `label` element or elements <a data-cite="accname-1.2/#dfn-accessible-name">accessible name(s)a> - if more than one `label` is associated; concatenate by DOM order, delimited by spaces.
58635883
li>
58645884
<li>If the <a data-cite="accname-1.2/#dfn-accessible-name">accessible namea> is still empty, then: use the control's `title` attribute.li>
58655885
<li>Otherwise use the control's <a href="#att-placeholder">placeholdera> value.li>
@@ -5948,7 +5968,7 @@

`output` Element Accessible Name Computation

59485968
<li>
59495969
If the `output` element has an <a data-cite="wai-aria-1.2/#aria-label">`aria-label`a> or an <a data-cite="wai-aria-1.2/#aria-labelledby">`aria-labelledby`a> attribute the <a data-cite="accname-1.2/#dfn-accessible-name">accessible namea> is to be calculated using the algorithm defined in <a href="" class="accname">Accessible Name and Description: Computation and API Mappingsa>.
59505970
li>
5951-
<li>Otherwise use the `output` element subtree.li>
5971+
<li>Otherwise use the associated `label` element or elements <a data-cite="accname-1.2/#dfn-accessible-name">accessible name(s)a> - if more than one `label` is associated; concatenate by DOM order, delimited by spaces.li>
59525972
<li>Otherwise use `title` attribute.li>
59535973
<li>
59545974
If none of the above yield a usable text string there is no <a data-cite="accname-1.2/#dfn-accessible-name">accessible namea>.
@@ -6157,6 +6177,9 @@

Change Log

61576177
<section>
61586178
<h4>Substantive changes since moving to the <a href="https://www.w3.org/WAI/ARIA/">Accessible Rich Internet Applications Working Groupa> (03-Nov-2019)h4>
61596179
<ul>
6180+
<li>08-Mar-2023: Update `hgroup` element to be mapped to `role=group`. See <a href="https://github.com/w3c/html-aam/pull/398">GitHub PR 398a>.li>
6181+
<li>08-Mar-2023: Clarify naming algorithm for `output` element. See <a href="https://github.com/w3c/html-aam/pull/402">GitHub PR 402a>.li>
6182+
<li>12-Dec-2022: Revise mapping for `s` element to be `role=deletion`. See <a href="https://github.com/w3c/html-aam/pull/442">GitHub PR 442a>.li>
61606183
<li>28-Nov-2022: Simplify accessible description computation section. See <a href="https://github.com/w3c/html-aam/pull/444">GitHub PR 444a>.li>
61616184
<li>19-Jul-2022: Update `address` element to be mapped to `role=group`. See <a href="https://github.com/w3c/html-aam/pull/420">GitHub PR 420a>.li>
61626185
<li>03-Apr-2022: Update `aside` mappings based on its nesting context. See <a href="https://github.com/w3c/html-aam/pull/350">GitHub PR 350a>.li>

0 commit comments

Comments
 (0)