Skip to content

Commit 966b175

Browse files
scottaoharascottaohara
authored
Update unnamed section mapping (#475)
closes #474 changes ref of section element without name from 'no corresponding role' to `role=generic`. other changes made in this PR: - remove duplicate instances of code elements from ARIA roles (mostly instances of role=generic). - clarification for section element allowed roles - role=region not recommended in general, not just if the element is named since using the role w/out naming would be useless. mention authors SHOULD NOT use role=generic on the element, per the change from no corresponding role.
1 parent a0033ad commit 966b175

File tree

1 file changed

+54
-52
lines changed

1 file changed

+54
-52
lines changed

‎index.html

Lines changed: 54 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -531,11 +531,11 @@ <h2 id="docconformance">
531531
[^a^] without [^a/href^]
532532
</th>
533533
<td>
534-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
534+
<code>role=<a href="#index-aria-generic">generic</a></code>
535535
</td>
536536
<td>
537537
<p>
538-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
538+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
539539
</p>
540540
<p class="addition"><a>Naming Prohibited</a></p>
541541
<p>
@@ -602,14 +602,14 @@ <h2 id="docconformance">
602602
[^area^] without [^area/href^]
603603
</th>
604604
<td>
605-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
605+
<code>role=<a href="#index-aria-generic">generic</a></code>
606606
</td>
607607
<td>
608608
<div class="addition">
609609
<p>
610610
Roles:
611611
<a href="#index-aria-button">`button`</a>
612-
or <a href="#index-aria-link">`link`</a>. (<code><a href="#index-aria-generic">`generic`</a></code> is also allowed, but SHOULD NOT BE USED.)
612+
or <a href="#index-aria-link">`link`</a>. (<code><a href="#index-aria-generic">generic</a></code> is also allowed, but SHOULD NOT BE USED.)
613613
</p>
614614
<p><a>Naming Prohibited</a></p>
615615
<p>
@@ -702,7 +702,7 @@ <h2 id="docconformance">
702702
Role exposed from author defined {{ElementInternals}}
703703
</p>
704704
<p>
705-
Otherwise <code>role=<a href="#index-aria-generic">`generic`</a></code>
705+
Otherwise <code>role=<a href="#index-aria-generic">generic</a></code>
706706
</p>
707707
</td>
708708
<td>
@@ -711,7 +711,7 @@ <h2 id="docconformance">
711711
<a><strong class="nosupport">no `role`</strong></a>
712712
</p>
713713
<p>
714-
Otherwise, <a><strong>any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
714+
Otherwise, <a><strong>any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
715715
</p>
716716
<p class="addition">
717717
<a>Naming Prohibited</a> if exposed as the `generic` role, or if exposed
@@ -728,11 +728,11 @@ <h2 id="docconformance">
728728
[^b^]
729729
</th>
730730
<td>
731-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
731+
<code>role=<a href="#index-aria-generic">generic</a></code>
732732
</td>
733733
<td>
734734
<p>
735-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
735+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
736736
</p>
737737
<p class="addition"><a>Naming Prohibited</a></p>
738738
<p>
@@ -759,11 +759,11 @@ <h2 id="docconformance">
759759
[^bdi^]
760760
</th>
761761
<td>
762-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
762+
<code>role=<a href="#index-aria-generic">generic</a></code>
763763
</td>
764764
<td>
765765
<p>
766-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
766+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
767767
</p>
768768
<p class="addition"><a>Naming Prohibited</a></p>
769769
<p>
@@ -777,11 +777,11 @@ <h2 id="docconformance">
777777
[^bdo^]
778778
</th>
779779
<td>
780-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
780+
<code>role=<a href="#index-aria-generic">generic</a></code>
781781
</td>
782782
<td>
783783
<p>
784-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
784+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
785785
</p>
786786
<p class="addition"><a>Naming Prohibited</a></p>
787787
<p>
@@ -812,11 +812,11 @@ <h2 id="docconformance">
812812
[^body^]
813813
</th>
814814
<td>
815-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
815+
<code>role=<a href="#index-aria-generic">generic</a></code>
816816
</td>
817817
<td>
818818
<p>
819-
<a><strong class="nosupport">No `role`</strong></a> other than <code><a href="#index-aria-generic">`generic`</a></code>, which SHOULD NOT be used.
819+
<a><strong class="nosupport">No `role`</strong></a> other than <code><a href="#index-aria-generic">generic</a></code>, which SHOULD NOT be used.
820820
</p>
821821
<p class="addition"><a>Naming Prohibited</a></p>
822822
<p>
@@ -974,11 +974,11 @@ <h2 id="docconformance">
974974
[^data^]
975975
</th>
976976
<td>
977-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
977+
<code>role=<a href="#index-aria-generic">generic</a></code>
978978
</td>
979979
<td>
980980
<p>
981-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
981+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
982982
</p>
983983
<p class="addition"><a>Naming Prohibited</a></p>
984984
<p>
@@ -1097,14 +1097,14 @@ <h2 id="docconformance">
10971097
[^div^]
10981098
</th>
10991099
<td>
1100-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
1100+
<code>role=<a href="#index-aria-generic">generic</a></code>
11011101
</td>
11021102
<td>
11031103
<p class="addition">
11041104
If a direct child of a [^dl^] element,
11051105
only <a href="#index-aria-presentation">`presentation`</a>
11061106
or <a href="#index-aria-none">`none`</a>. Otherwise,
1107-
<a><strong>any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
1107+
<a><strong>any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
11081108
</p>
11091109
<p class="addition"><a>Naming Prohibited</a></p>
11101110
<p>
@@ -1273,7 +1273,7 @@ <h2 id="docconformance">
12731273
then <code>role=<a href="#index-aria-contentinfo">contentinfo</a></code>
12741274
</p>
12751275
<p>
1276-
Otherwise, <code>role=<a href="#index-aria-generic">`generic`</a></code>
1276+
Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code>
12771277
</p>
12781278
</td>
12791279
<td>
@@ -1287,7 +1287,7 @@ <h2 id="docconformance">
12871287
`main`, `navigation` or `region`,
12881288
then <code>role=<a href="#index-aria-contentinfo">contentinfo</a></code>
12891289
is also allowed, but NOT RECOMMENDED.
1290-
Otherwise, <code>role=<a href="#index-aria-generic">`generic`</a></code>
1290+
Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code>
12911291
is also allowed, but SHOULD NOT be used.)
12921292
</p>
12931293
<p>
@@ -1335,7 +1335,7 @@ <h2 id="docconformance">
13351335
Role exposed from author defined {{ElementInternals}}
13361336
</p>
13371337
<p>
1338-
Otherwise <code>role=<a href="#index-aria-generic">`generic`</a></code>
1338+
Otherwise <code>role=<a href="#index-aria-generic">generic</a></code>
13391339
</p>
13401340
</td>
13411341
<td>
@@ -1357,7 +1357,7 @@ <h2 id="docconformance">
13571357
<a href="#index-aria-slider">`slider`</a>,
13581358
<a href="#index-aria-spinbutton">`spinbutton`</a>,
13591359
<a href="#index-aria-switch">`switch`</a>
1360-
or <a href="#index-aria-textbox">`textbox`</a>. (<code><a href="#index-aria-generic">`generic`</a></code> is also allowed, but SHOULD NOT be used.)
1360+
or <a href="#index-aria-textbox">`textbox`</a>. (<code><a href="#index-aria-generic">generic</a></code> is also allowed, but SHOULD NOT be used.)
13611361
</p>
13621362
<p class="addition">
13631363
<a>Naming Prohibited</a> if exposed as the `generic` role.
@@ -1418,7 +1418,7 @@ <h2 id="docconformance">
14181418
<code>role=<a href="#index-aria-banner">banner</a></code>
14191419
</p>
14201420
<p>
1421-
Otherwise, <code>role=<a href="#index-aria-generic">`generic`</a></code>
1421+
Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code>
14221422
</p>
14231423
</td>
14241424
<td>
@@ -1432,7 +1432,7 @@ <h2 id="docconformance">
14321432
`main`, `navigation` or `region`,
14331433
then <code>role=<a href="#index-aria-contentinfo">contentinfo</a></code>
14341434
is also allowed, but NOT RECOMMENDED.
1435-
Otherwise, <code>role=<a href="#index-aria-generic">`generic`</a></code>
1435+
Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code>
14361436
is also allowed, but SHOULD NOT be used.)
14371437
</p>
14381438
<p class="addition"><a>Naming Prohibited</a> if exposed as `generic`.</p>
@@ -1447,11 +1447,11 @@ <h2 id="docconformance">
14471447
[^hgroup^]
14481448
</th>
14491449
<td>
1450-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
1450+
<code>role=<a href="#index-aria-generic">generic</a></code>
14511451
</td>
14521452
<td>
14531453
<p>
1454-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
1454+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
14551455
</p>
14561456
<p class="addition"><a>Naming Prohibited</a></p>
14571457
<p>
@@ -1504,11 +1504,11 @@ <h2 id="docconformance">
15041504
[^i^]
15051505
</th>
15061506
<td>
1507-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
1507+
<code>role=<a href="#index-aria-generic">generic</a></code>
15081508
</td>
15091509
<td>
15101510
<p>
1511-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
1511+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
15121512
</p>
15131513
<p class="addition"><a>Naming Prohibited</a></p>
15141514
<p>
@@ -2521,11 +2521,11 @@ <h2 id="docconformance">
25212521
[^pre^]
25222522
</th>
25232523
<td>
2524-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
2524+
<code>role=<a href="#index-aria-generic">generic</a></code>
25252525
</td>
25262526
<td>
25272527
<p>
2528-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
2528+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
25292529
</p>
25302530
<p class="addition"><a>Naming Prohibited</a></p>
25312531
<p>
@@ -2561,11 +2561,11 @@ <h2 id="docconformance">
25612561
[^q^]
25622562
</th>
25632563
<td>
2564-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
2564+
<code>role=<a href="#index-aria-generic">generic</a></code>
25652565
</td>
25662566
<td>
25672567
<p>
2568-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
2568+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
25692569
</p>
25702570
<p class="addition"><a>Naming Prohibited</a></p>
25712571
<p>
@@ -2649,11 +2649,11 @@ <h2 id="docconformance">
26492649
[^samp^]
26502650
</th>
26512651
<td>
2652-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
2652+
<code>role=<a href="#index-aria-generic">generic</a></code>
26532653
</td>
26542654
<td>
26552655
<p>
2656-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
2656+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
26572657
</p>
26582658
<p class="addition"><a>Naming Prohibited</a></p>
26592659
<p>
@@ -2713,7 +2713,7 @@ <h2 id="docconformance">
27132713
<a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>
27142714
</p>
27152715
<p>
2716-
Otherwise, <a>no corresponding role</a>
2716+
Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code>
27172717
</p>
27182718
</td>
27192719
<td>
@@ -2739,9 +2739,8 @@ <h2 id="docconformance">
27392739
<a href="#index-aria-search">`search`</a>,
27402740
<a href="#index-aria-status">`status`</a>
27412741
or <a href="#index-aria-tabpanel">`tabpanel`</a>.
2742-
(If the [^section^] element has an
2743-
<a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>,
2744-
<code>role=<a href="#index-aria-region">region</a></code> is also allowed, but NOT RECOMMENDED.)
2742+
(<code>role=<a href="#index-aria-region">region</a></code> is also allowed,
2743+
but NOT RECOMMENDED. <code>role=<a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.)
27452744
</p>
27462745
<p>
27472746
DPub Roles:
@@ -2842,11 +2841,11 @@ <h2 id="docconformance">
28422841
[^small^]
28432842
</th>
28442843
<td>
2845-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
2844+
<code>role=<a href="#index-aria-generic">generic</a></code>
28462845
</td>
28472846
<td>
28482847
<p>
2849-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
2848+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
28502849
</p>
28512850
<p class="addition"><a>Naming Prohibited</a></p>
28522851
<p>
@@ -2873,11 +2872,11 @@ <h2 id="docconformance">
28732872
[^span^]
28742873
</th>
28752874
<td>
2876-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
2875+
<code>role=<a href="#index-aria-generic">generic</a></code>
28772876
</td>
28782877
<td>
28792878
<p>
2880-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
2879+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
28812880
</p>
28822881
<p class="addition"><a>Naming Prohibited</a></p>
28832882
<p>
@@ -2971,11 +2970,11 @@ <h2 id="docconformance">
29712970
[^sup^]
29722971
</th>
29732972
<td>
2974-
<code>role=<a href="#index-aria-superscript">`superscript`</a></code>
2973+
<code>role=<a href="#index-aria-superscript">superscript</a></code>
29752974
</td>
29762975
<td>
29772976
<p>
2978-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-superscript">`superscript`</a></code> is NOT RECOMMENDED.
2977+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-superscript">superscript</a></code> is NOT RECOMMENDED.
29792978
</p>
29802979
<p class="addition"><a>Naming Prohibited</a></p>
29812980
<p>
@@ -3105,11 +3104,11 @@ <h2 id="docconformance">
31053104
[^time^]
31063105
</th>
31073106
<td>
3108-
<code>role=<a href="#index-aria-time">`time`</a></code>
3107+
<code>role=<a href="#index-aria-time">time</a></code>
31093108
</td>
31103109
<td>
31113110
<p>
3112-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-time">`time`</a></code> is NOT RECOMMENDED.
3111+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-time">time</a></code> is NOT RECOMMENDED.
31133112
</p>
31143113
<p class="addition"><a>Naming Prohibited</a></p>
31153114
<p>
@@ -3267,11 +3266,11 @@ <h2 id="docconformance">
32673266
[^u^]
32683267
</th>
32693268
<td>
3270-
<code>role=<a href="#index-aria-generic">`generic`</a></code>
3269+
<code>role=<a href="#index-aria-generic">generic</a></code>
32713270
</td>
32723271
<td>
32733272
<p>
3274-
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">`generic`</a></code> SHOULD NOT be used.
3273+
<a><strong>Any `role`</strong></a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.
32753274
</p>
32763275
<p class="addition"><a>Naming Prohibited</a></p>
32773276
<p>
@@ -3467,12 +3466,15 @@ <h3 id="docconformance-attr">
34673466
Requirements for use of ARIA attributes in place of equivalent HTML attributes
34683467
</h3>
34693468
<p>
3470-
Unless otherwise stated, authors MAY use `aria-*` attributes in place of their HTML equivalents on HTML elements where the `aria-*` semantics would be expected. For example, authors MAY specify `aria-disabled=true` on a [^button^] element, while also implementing the necessary scripting to functionally disable the `button`, rather than the use `disabled` attribute.
3469+
Unless otherwise stated, authors MAY use `aria-*` attributes in place of their HTML equivalents on HTML elements where the `aria-*` semantics would
3470+
be expected. For example, authors MAY specify `aria-disabled=true` on a [^button^] element, while also implementing the necessary scripting to functionally
3471+
disable the `button`, rather than the use `disabled` attribute.
34713472
</p>
34723473
<p>
3473-
As stated in
3474-
<a data-cite="wai-aria-1.2#host_general_conflict">WAI-ARIA's Conflicts with Host Language Semantics</a>,
3475-
when HTML elements use <em>both</em> `aria-*` attributes and their host language (HTML) equivalents, user agents MUST ignore the WAI-ARIA attributes – the native HTML attributes with the same <a>implicit ARIA semantics</a> take precedence. For this reason, authors SHOULD NOT specify both the native HTML attribute and the equivalent `aria-*` attribute on an element. Please review each attribute for any further author specific requirements.
3474+
As stated in <a data-cite="wai-aria-1.2#host_general_conflict">WAI-ARIA's Conflicts with Host Language Semantics</a>,
3475+
when HTML elements use <em>both</em> `aria-*` attributes and their host language (HTML) equivalents, user agents MUST ignore the WAI-ARIA attributes – the
3476+
native HTML attributes with the same <a>implicit ARIA semantics</a> take precedence. For this reason, authors SHOULD NOT specify both the native HTML attribute
3477+
and the equivalent `aria-*` attribute on an element. Please review each attribute for any further author specific requirements.
34763478
</p>
34773479
<p>
34783480
The following table represents HTML elements and their attributes which have `aria-*` attribute parity.

0 commit comments

Comments
 (0)