Skip to content

Commit b691826

Browse files
scottaoharascottaohara
authored
Merge branch 'gh-pages' into img-allow-math-role
2 parents d70ee10 + 7f7718c commit b691826

File tree

2 files changed

+41
-24
lines changed

2 files changed

+41
-24
lines changed

‎index.html‎

Lines changed: 40 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,14 @@
6464
the following substantive additions and/or corrections have been proposed:
6565
</p>
6666
<ul>
67+
<li>
68+
<a href="https://github.com/w3c/html-aria/pull/533">13 December 2024 - Addition:</a>
69+
Update to include the `image` role as preferred synonym to the `img` role.
70+
</li>
71+
<li>
72+
<a href="https://github.com/w3c/html-aria/pull/507">13 December 2024 - Addition:</a>
73+
Clarify the allowance for `aria-hidden` when used with the `hidden` attribute.
74+
</li>
6775
<li>
6876
<a href="https://github.com/w3c/html-aria/pull/489">4 October 2023 - Addition:</a>
6977
Update the button element and input type=button,image,reset,submit elements to allow the `separator` role.
@@ -487,7 +495,7 @@ <h2 id="docconformance">
487495
While it is conforming to use [[[dpub-aria-1.0]]] `role` values as outlined in the following table, the current support for
488496
exposing the semantics of these values to users of assistive technology is close to non-existent.
489497
</p>
490-
<table class="simple">
498+
<table class="data">
491499
<caption>
492500
Rules of ARIA attribute usage by HTML element
493501
</caption>
@@ -594,7 +602,7 @@ <h2 id="docconformance">
594602
</td>
595603
<td>
596604
<p>
597-
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> SHOULD NOT be used.
605+
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> is NOT RECOMMENDED.
598606
</p>
599607
<p>
600608
Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>
@@ -1213,6 +1221,7 @@ <h2 id="docconformance">
12131221
<a href="#index-aria-application">`application`</a>,
12141222
<a href="#index-aria-document">`document`</a>,
12151223
<a href="#index-aria-img">`img`</a>,
1224+
<a href="#index-aria-img">`image`</a>,
12161225
<a href="#index-aria-none">`none`</a>
12171226
or <a href="#index-aria-presentation">`presentation`</a>.
12181227
</p>
@@ -1481,7 +1490,7 @@ <h2 id="docconformance">
14811490
</td>
14821491
<td>
14831492
<p>
1484-
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> SHOULD NOT be used.
1493+
<a><strong>Any `role`</strong></a>, though <a href="#index-aria-group">`group`</a> is NOT RECOMMENDED.
14851494
</p>
14861495
<p>
14871496
Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>
@@ -1559,6 +1568,7 @@ <h2 id="docconformance">
15591568
<a href="#index-aria-application">`application`</a>,
15601569
<a href="#index-aria-document">`document`</a>,
15611570
<a href="#index-aria-img">`img`</a>,
1571+
<a href="#index-aria-img">`image`</a>,
15621572
<a href="#index-aria-none">`none`</a>
15631573
or <a href="#index-aria-presentation">`presentation`</a>.
15641574
</p>
@@ -1577,7 +1587,7 @@ <h2 id="docconformance">
15771587
<td>
15781588
If the `img` has non-empty [^img/alt^] (`alt="some text"`) or an accessible name is provided another
15791589
<a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming method</a>:<br>
1580-
<code>role=<a href="#index-aria-img">img</a></code>
1590+
<code>role=<a href="#index-aria-img">img or image</a></code>
15811591
</td>
15821592
<td>
15831593
<p>
@@ -1605,7 +1615,7 @@ <h2 id="docconformance">
16051615
<a href="#index-aria-switch">`switch`</a>,
16061616
<a href="#index-aria-tab">`tab`</a> or
16071617
<a href="#index-aria-treeitem">`treeitem`</a>.
1608-
(<code><a href="#index-aria-img">img</a></code> is also allowed, but NOT RECOMMENDED.)
1618+
(<code><a href="#index-aria-img">img or image</a></code> is also allowed, but NOT RECOMMENDED.)
16091619
</p>
16101620
<p>
16111621
DPub Role:
@@ -1632,7 +1642,7 @@ <h2 id="docconformance">
16321642
<p id="el-img-no-alt" tabindex="-1">
16331643
If the `img` <a data-cite="html/images.html#unknown-images">lacks an `alt` attribute</a> and lacks any other
16341644
<a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming methods</a>:<br>
1635-
<code>role=<a href="#index-aria-img">img</a></code>
1645+
<code>role=<a href="#index-aria-img">img or image</a></code>
16361646
</p>
16371647
</div>
16381648
</td>
@@ -1642,7 +1652,7 @@ <h2 id="docconformance">
16421652
If the `img` has no `alt` attribute or accessible name:
16431653
<a><strong class="nosupport">No `role`</strong></a> other than the
16441654
<code>role=<a href="#index-aria-none">none</a></code> or <code><a href="#index-aria-presentation">presentation</a></code> roles.
1645-
(<code>role=<a href="#index-aria-img">img</a></code> is also allowed, but NOT RECOMMENDED.)
1655+
(<code>role=<a href="#index-aria-img">img or image</a></code> is also allowed, but NOT RECOMMENDED.)
16461656
</p>
16471657
<p>
16481658
If the `img` has an empty `alt=""` attribute and no `aria-label` or `aria-labelledby` attributes to provide it an accessible name:
@@ -2476,8 +2486,9 @@ <h2 id="docconformance">
24762486
<p>
24772487
Roles:
24782488
<a href="#index-aria-application">`application`</a>,
2479-
<a href="#index-aria-document">`document`</a>
2480-
or <a href="#index-aria-img">`img`</a>.
2489+
<a href="#index-aria-document">`document`</a>,
2490+
<a href="#index-aria-img">`img`</a>
2491+
or <a href="#index-aria-img">`image`</a>.
24812492
</p>
24822493
<p>
24832494
<a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and
@@ -3594,7 +3605,7 @@ <h3 id="docconformance-attr">
35943605
requirements for using the `aria-*` attributes that supply the same
35953606
<a>implicit ARIA semantics</a>.
35963607
</p>
3597-
<table class="simple">
3608+
<table class="data">
35983609
<caption>
35993610
Rules of ARIA attribute usage by HTML feature
36003611
</caption>
@@ -3652,7 +3663,8 @@ <h3 id="docconformance-attr">
36523663
Use the `disabled` attribute on any element that is allowed the `disabled` attribute in HTML.
36533664
</p>
36543665
<p>
3655-
Authors MAY use the <a data-cite="wai-aria-1.2#aria-disabled">`aria-disabled`</a> attribute on any element that is allowed the `disabled` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-disabled` attribute</a>.
3666+
Authors MAY use the <a data-cite="wai-aria-1.2#aria-disabled">`aria-disabled`</a> attribute on any element that is allowed the `disabled` attribute in HTML,
3667+
or any element with a WAI-ARIA role which allows the `aria-disabled` attribute</a>.
36563668
</p>
36573669
<p>
36583670
Authors SHOULD NOT use `aria-disabled="true"` on any element which also has a `disabled` attribute.
@@ -3671,19 +3683,22 @@ <h3 id="docconformance-attr">
36713683
</td>
36723684
<td>
36733685
<p>
3674-
Authors MAY use the <a data-cite="wai-aria-1.2#aria-hidden">`aria-hidden`</a> attribute on any HTML element that allows <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>, with the following exception:
3686+
Authors MAY use the <a data-cite="wai-aria-1.2#aria-hidden">`aria-hidden`</a> attribute on any HTML element that allows <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> to
3687+
be specified, with the exception of focusable elements and the <a href="#el-body">`body`</a> element.
36753688
</p>
36763689
<p>
3677-
Authors SHOULD NOT use the `aria-hidden="true"` attribute on any element which also has a `hidden` attribute.
3690+
It is generally NOT RECOMMENDED for authors to use `aria-hidden="true"` on any element which also has the `hidden` attribute specified. However, authors MUST NOT use `aria-hidden="true"` on any element which also has the `hidden` attribute specified in the `until-found` state.
36783691
</p>
3679-
3680-
<!-- this will be covered as part of issue 221 -->
3681-
<!-- <p>
3682-
Authors MUST NOT use `aria-hidden="true"` on an element that can receive keyboard focus, or on an ancestor element to an element or elements which can receive keyboard focus.
3683-
</p>
3684-
<p>
3685-
Any elements which can receive keyboard focus, interactive elements or otherwise, MUST have their ability to receive keyboard focus removed while the `aria-hidden="true"` attribute is present. For instance, by using `tabindex="-1"` on any focusable elements with `aria-hidden="true"`, or setting `tabindex="-1"` to focusable elements that are descendants of an `aria-hidden="true"` containing element.
3686-
</p> -->
3692+
<div class="note">
3693+
A focusable element is any element which can be focused by use of keyboard or pointer device. Focusable elements are not always elements which
3694+
can be tabbed to via a keyboard. For instance, an element with `tabindex="-1"` is focusable but is not a tabbable element.
3695+
</div>
3696+
<div class="note">
3697+
Using `aria-hidden="true"` on an element that has the `hidden` attribute is at best an unnecessary redundancy. At worst its usage can
3698+
prevent access to the content if the `hidden` attribute's default UA style of `display: none` has been purposeuflly overwritten by an author or user style sheet.
3699+
Finally, if the `hidden` attribute has the value of `until-found`, the use of `aria-hidden=true` will prevent this content from being discoverable to users of assistive
3700+
technology when it is found via a browser's in-page find feature and visually rendered to users.
3701+
</div>
36873702
</td>
36883703
</tr>
36893704
<tr id="att-placeholder" tabindex="-1">
@@ -3699,7 +3714,8 @@ <h3 id="docconformance-attr">
36993714
`placeholder` attribute in HTML.
37003715
</p>
37013716
<p>
3702-
Authors MAY use the <a data-cite="wai-aria-1.2#aria-placeholder">`aria-placeholder`</a> attribute on any element that is allowed the `placeholder` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-placeholder` attribute.
3717+
Authors MAY use the <a data-cite="wai-aria-1.2#aria-placeholder">`aria-placeholder`</a> attribute on any element that is allowed the `placeholder` attribute in HTML,
3718+
or any element with a WAI-ARIA role which allows the `aria-placeholder` attribute.
37033719
</p>
37043720
<p>
37053721
Authors MUST NOT use the `aria-placeholder` attribute on any element which also has a `placeholder` attribute.
@@ -4002,7 +4018,7 @@ <h2>
40024018
Additionally, there are certain roles which [[[wai-aria-1.2]]] has specified specific requirements for their allowed descendants. These have been identified in column 3 (Descendant allowances) by indicating to "Refer to the 'Required Owned Elements'" for those particular roles.
40034019
</p>
40044020

4005-
<table id="aria-table" class="simple">
4021+
<table id="aria-table" class="data">
40064022
<caption>
40074023
Allowed descendants of ARIA roles
40084024
</caption>
@@ -4411,7 +4427,7 @@ <h2>
44114427
</tr>
44124428
<tr>
44134429
<th tabindex="-1" id="index-aria-img">
4414-
<a data-cite="wai-aria-1.2#img">`img`</a>
4430+
<a data-cite="wai-aria-1.2#img">`img` or `image`</a>
44154431
</th>
44164432
<td>
44174433
<ul>

‎makeup.css‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,7 @@ table td ul {
5757
so these updates were made to make these work better in
5858
this spec. */
5959
span.addition.proposed,
60+
span.addition.correction,
6061
span.correction.proposed,
6162
span.amendment.proposed {
6263
padding: .125em .25em;

0 commit comments

Comments
 (0)