Skip to content

Commit ef1ad85

Browse files
jnurthen#1988 Makes aria-braillelabel prohibited whereever aria-label is prohibited.
1 parent efd00e4 commit ef1ad85

File tree

2 files changed

+75
-1
lines changed

2 files changed

+75
-1
lines changed

‎index.html

+18-1
Original file line numberDiff line numberDiff line change
@@ -1891,6 +1891,7 @@ <h2>Definition of Roles</h2>
18911891
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
18921892
<td class="role-disallowed">
18931893
<ul>
1894+
<li><pref>aria-braillelabel</pref></li>
18941895
<li><pref>aria-label</pref></li>
18951896
<li><pref>aria-labelledby</pref></li>
18961897
</ul>
@@ -2179,6 +2180,7 @@ <h2>Definition of Roles</h2>
21792180
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
21802181
<td class="role-disallowed">
21812182
<ul>
2183+
<li><pref>aria-braillelabel</pref></li>
21822184
<li><pref>aria-label</pref></li>
21832185
<li><pref>aria-labelledby</pref></li>
21842186
</ul>
@@ -2940,6 +2942,7 @@ <h2>Definition of Roles</h2>
29402942
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
29412943
<td class="role-disallowed">
29422944
<ul>
2945+
<li><pref>aria-braillelabel</pref></li>
29432946
<li><pref>aria-label</pref></li>
29442947
<li><pref>aria-labelledby</pref></li>
29452948
</ul>
@@ -3028,6 +3031,7 @@ <h2>Definition of Roles</h2>
30283031
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
30293032
<td class="role-disallowed">
30303033
<ul>
3034+
<li><pref>aria-braillelabel</pref></li>
30313035
<li><pref>aria-label</pref></li>
30323036
<li><pref>aria-labelledby</pref></li>
30333037
</ul>
@@ -3355,6 +3359,7 @@ <h2>Definition of Roles</h2>
33553359
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
33563360
<td class="role-disallowed">
33573361
<ul>
3362+
<li><pref>aria-braillelabel</pref></li>
33583363
<li><pref>aria-label</pref></li>
33593364
<li><pref>aria-labelledby</pref></li>
33603365
</ul>
@@ -3698,6 +3703,7 @@ <h2>Definition of Roles</h2>
36983703
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
36993704
<td class="role-disallowed">
37003705
<ul>
3706+
<li><pref>aria-braillelabel</pref></li>
37013707
<li><pref>aria-brailleroledescription</pref></li>
37023708
<li><pref>aria-label</pref></li>
37033709
<li><pref>aria-labelledby</pref></li>
@@ -4338,6 +4344,7 @@ <h2>Definition of Roles</h2>
43384344
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
43394345
<td class="role-disallowed">
43404346
<ul>
4347+
<li><pref>aria-braillelabel</pref></li>
43414348
<li><pref>aria-label</pref></li>
43424349
<li><pref>aria-labelledby</pref></li>
43434350
</ul>
@@ -5048,6 +5055,7 @@ <h2>Definition of Roles</h2>
50485055
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
50495056
<td class="role-disallowed">
50505057
<ul>
5058+
<li><pref>aria-braillelabel</pref></li>
50515059
<li><pref>aria-label</pref></li>
50525060
<li><pref>aria-labelledby</pref></li>
50535061
</ul>
@@ -6075,6 +6083,7 @@ <h5>Presentational Role Inheritance</h5>
60756083
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
60766084
<td class="role-disallowed">
60776085
<ul>
6086+
<li><pref>aria-braillelabel</pref></li>
60786087
<li><pref>aria-label</pref></li>
60796088
<li><pref>aria-labelledby</pref></li>
60806089
</ul>
@@ -6481,6 +6490,7 @@ <h5>Presentational Role Inheritance</h5>
64816490
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
64826491
<td class="role-disallowed">
64836492
<ul>
6493+
<li><pref>aria-braillelabel</pref></li>
64846494
<li><pref>aria-label</pref></li>
64856495
<li><pref>aria-labelledby</pref></li>
64866496
</ul>
@@ -8283,6 +8293,7 @@ <h5>Presentational Role Inheritance</h5>
82838293
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
82848294
<td class="role-disallowed">
82858295
<ul>
8296+
<li><pref>aria-braillelabel</pref></li>
82868297
<li><pref>aria-label</pref></li>
82878298
<li><pref>aria-labelledby</pref></li>
82888299
</ul>
@@ -8441,6 +8452,7 @@ <h5>Presentational Role Inheritance</h5>
84418452
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
84428453
<td class="role-disallowed">
84438454
<ul>
8455+
<li><pref>aria-braillelabel</pref></li>
84448456
<li><pref>aria-label</pref></li>
84458457
<li><pref>aria-labelledby</pref></li>
84468458
</ul>
@@ -8544,6 +8556,7 @@ <h5>Presentational Role Inheritance</h5>
85448556
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
85458557
<td class="role-disallowed">
85468558
<ul>
8559+
<li><pref>aria-braillelabel</pref></li>
85478560
<li><pref>aria-label</pref></li>
85488561
<li><pref>aria-labelledby</pref></li>
85498562
</ul>
@@ -8631,6 +8644,7 @@ <h5>Presentational Role Inheritance</h5>
86318644
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
86328645
<td class="role-disallowed">
86338646
<ul>
8647+
<li><pref>aria-braillelabel</pref></li>
86348648
<li><pref>aria-label</pref></li>
86358649
<li><pref>aria-labelledby</pref></li>
86368650
</ul>
@@ -9187,6 +9201,7 @@ <h5>Presentational Role Inheritance</h5>
91879201
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
91889202
<td class="role-disallowed">
91899203
<ul>
9204+
<li><pref>aria-braillelabel</pref></li>
91909205
<li><pref>aria-label</pref></li>
91919206
<li><pref>aria-labelledby</pref></li>
91929207
</ul>
@@ -9502,6 +9517,7 @@ <h5>Presentational Role Inheritance</h5>
95029517
<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
95039518
<td class="role-disallowed">
95049519
<ul>
9520+
<li><pref>aria-braillelabel</pref></li>
95059521
<li><pref>aria-label</pref></li>
95069522
<li><pref>aria-labelledby</pref></li>
95079523
</ul>
@@ -10685,6 +10701,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
1068510701
<li>The value of <code>aria-braillelabel</code> does not contain any characters in <a>Unicode Braille Patterns</a> or consists of only characters in <a>Unicode Braille Patterns</a>; the value does not only contain Braille Pattern dots-0.</li>
1068610702
<li>The value of <code>aria-braillelabel</code> is not identical to the element's accessible name.</li>
1068710703
</ol>
10704+
<p>Authors MUST NOT specify <code>aria-braillelabel</code> on an element which has an explicit or implicit WAI-ARIA role where <code>aria-braillelabel</code> is <a href="#prohibitedattributes">prohibited</a>.</p>
1068810705
<p class="note">Note that <a>Assistive Technologies</a> with braille support can convert the accessible name to Braille. In addition, assistive technologies will be able to customize such braille output according to user preferences. Using only the accessible name, e.g., from content or via <code>aria-label</code> is <strong>almost always</strong> the better user experience and authors are <strong>strongly discouraged</strong> from using <code>aria-braillelabel</code> to replicate <code>aria-label</code>. Instead, <code>aria-braillelabel</code> is meant to be used only if the accessible name cannot provide an adequate braille representation, i.e., when a specialized braille description is very different from a text description converted to Braille. It is very important to note that when using <code>aria-braillelabel</code> authors are solely responsible for localizing the attribute value so that it aligns with the document language. In addition, authors need to design a way to clearly communicate the use of this attribute to the user. For example, this could be done in the product documentation. This is even more important when the value consists of Unicode Braille Patterns because <a>Assistive Technologies</a> will pass such content directly to the user without applying user specific braille translations; in general, authors are <strong>strongly discouraged</strong> from using Unicode Braille Patterns in <code>aria-braillelabel</code>.
1068910706
</p>
1069010707
<p><a>Assistive technologies</a> SHOULD use the value of <code>aria-braillelabel</code> when presenting the accessible name of an element in Braille, but SHOULD NOT change other functionality. For example, an assistive technology that provides aural rendering SHOULD use the accessible name.</p>
@@ -10709,7 +10726,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
1070910726
<tbody>
1071010727
<tr>
1071110728
<th class="property-applicability-head" scope="row">Used in Roles:</th>
10712-
<td class="property-applicability">All elements of the base markup</td>
10729+
<td class="property-applicability">All elements of the base markup except for some roles or elements that prohibit its use</td>
1071310730
</tr>
1071410731
<tr>
1071510732
<th class="property-descendants-head" scope="row">Inherits into Roles:</th>

‎validator-tests/braillelabel-prohibited.html

+57
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
<!DOCTYPE html>
2+
<html lang="en-US">
3+
<head><title>BrailleLabel Prohibited</title></head>
4+
<body>
5+
6+
<!--
7+
URL: https://www.w3.org/TR/wai-aria-1.3/#aria-braillelabel
8+
RULE: "Authors MUST NOT specify aria-braillelabel on an element which has an explicit or implicit WAI-ARIA role where aria-braillelabel is prohibited."
9+
-->
10+
11+
<!-- aria-label -->
12+
<div id="aria-label-1" role="code" aria-braillelabel="foo">bar</div>
13+
<code id="aria-label-2" aria-label="foo">bar</code>
14+
15+
<div id="aria-label-3" role="deletion" aria-braillelabel="foo">bar</div>
16+
<del id="aria-label-4" aria-label="foo">bar</del>
17+
18+
<div id="aria-label-5" role="emphasis" aria-braillelabel="foo">bar</div>
19+
<em id="aria-label-6" aria-label="foo">bar</em>
20+
21+
<div id="aria-label-7" role="generic" aria-braillelabel="foo">bar</div>
22+
<div id="aria-label-8" aria-label="foo">bar</div>
23+
24+
<div id="aria-label-9" role="insertion" aria-braillelabel="foo">bar</div>
25+
<ins id="aria-label-10" aria-label="foo">bar</ins>
26+
27+
<div id="aria-label-11" role="paragraph" aria-braillelabel="foo">bar</div>
28+
<p id="aria-label-12" aria-label="foo">bar</p>
29+
30+
<div id="aria-label-13" role="presentation" aria-braillelabel="foo">bar</div>
31+
<div id="aria-label-14" role="none" aria-label="foo">bar</div>
32+
33+
<div id="aria-label-15" role="strong" aria-braillelabel="foo">bar</div>
34+
<strong id="aria-label-16" aria-label="foo">bar</strong>
35+
36+
<div id="aria-label-17" role="subscript" aria-braillelabel="foo">bar</div>
37+
<sub id="aria-label-18" aria-label="foo">bar</sub>
38+
39+
<div id="aria-label-19" role="superscript" aria-braillelabel="foo">bar</div>
40+
<sup id="aria-label-20" aria-label="foo">bar</sup>
41+
42+
<div role="table">
43+
<div id="aria-label-21" role="caption" aria-braillelabel="foo">bar</div>
44+
<div role="row">
45+
<div role="cell">baz</div>
46+
</div>
47+
</div>
48+
<table>
49+
<caption id="aria-label-22" aria-braillelabel="foo">bar</caption>
50+
<tr>
51+
<td>baz</td>
52+
</tr>
53+
</table>
54+
55+
</body>
56+
</html>
57+

0 commit comments

Comments
 (0)

Follow Lee on X/Twitter - Father, Husband, Serial builder creating AI, crypto, games & web tools. We are friends :) AI Will Come To Life!

Check out: eBank.nz (Art Generator) | Netwrck.com (AI Tools) | Text-Generator.io (AI API) | BitBank.nz (Crypto AI) | ReadingTime (Kids Reading) | RewordGame | BigMultiplayerChess | WebFiddle | How.nz | Helix AI Assistant