Skip to content

Commit 7f7718c

Browse files
authored
Update: acknowledge the image role (#533)
* Update: acknowledge the image role role=`image` is the preferred default role, over the previous and still valid `img` role. update the spec to call out the existence / allowance of the `image` role. * add changelog
1 parent ca48852 commit 7f7718c

File tree

1 file changed

+14
-7
lines changed

1 file changed

+14
-7
lines changed

index.html

+14-7
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,10 @@
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>
6771
<li>
6872
<a href="https://github.com/w3c/html-aria/pull/507">13 December 2024 - Addition:</a>
6973
Clarify the allowance for `aria-hidden` when used with the `hidden` attribute.
@@ -1217,6 +1221,7 @@ <h2 id="docconformance">
12171221
<a href="#index-aria-application">`application`</a>,
12181222
<a href="#index-aria-document">`document`</a>,
12191223
<a href="#index-aria-img">`img`</a>,
1224+
<a href="#index-aria-img">`image`</a>,
12201225
<a href="#index-aria-none">`none`</a>
12211226
or <a href="#index-aria-presentation">`presentation`</a>.
12221227
</p>
@@ -1563,6 +1568,7 @@ <h2 id="docconformance">
15631568
<a href="#index-aria-application">`application`</a>,
15641569
<a href="#index-aria-document">`document`</a>,
15651570
<a href="#index-aria-img">`img`</a>,
1571+
<a href="#index-aria-img">`image`</a>,
15661572
<a href="#index-aria-none">`none`</a>
15671573
or <a href="#index-aria-presentation">`presentation`</a>.
15681574
</p>
@@ -1581,7 +1587,7 @@ <h2 id="docconformance">
15811587
<td>
15821588
If the `img` has non-empty [^img/alt^] (`alt="some text"`) or an accessible name is provided another
15831589
<a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming method</a>:<br>
1584-
<code>role=<a href="#index-aria-img">img</a></code>
1590+
<code>role=<a href="#index-aria-img">img or image</a></code>
15851591
</td>
15861592
<td>
15871593
<p>
@@ -1605,7 +1611,7 @@ <h2 id="docconformance">
16051611
<a href="#index-aria-slider">`slider`</a>,
16061612
<a href="#index-aria-switch">`switch`</a>,
16071613
<a href="#index-aria-tab">`tab`</a> or
1608-
<a href="#index-aria-treeitem">`treeitem`</a>. (<code><a href="#index-aria-img">img</a></code> is also allowed, but NOT RECOMMENDED.)
1614+
<a href="#index-aria-treeitem">`treeitem`</a>. (<code><a href="#index-aria-img">img or image</a></code> is also allowed, but NOT RECOMMENDED.)
16091615
</p>
16101616
<p>
16111617
DPub Role:
@@ -1632,7 +1638,7 @@ <h2 id="docconformance">
16321638
<p id="el-img-no-alt" tabindex="-1">
16331639
If the `img` <a data-cite="html/images.html#unknown-images">lacks an `alt` attribute</a> and lacks any other
16341640
<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>
1641+
<code>role=<a href="#index-aria-img">img or image</a></code>
16361642
</p>
16371643
</div>
16381644
</td>
@@ -1642,7 +1648,7 @@ <h2 id="docconformance">
16421648
If the `img` has no `alt` attribute or accessible name:
16431649
<a><strong class="nosupport">No `role`</strong></a> other than the
16441650
<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.)
1651+
(<code>role=<a href="#index-aria-img">img or image</a></code> is also allowed, but NOT RECOMMENDED.)
16461652
</p>
16471653
<p>
16481654
If the `img` has an empty `alt=""` attribute and no `aria-label` or `aria-labelledby` attributes to provide it an accessible name:
@@ -2476,8 +2482,9 @@ <h2 id="docconformance">
24762482
<p>
24772483
Roles:
24782484
<a href="#index-aria-application">`application`</a>,
2479-
<a href="#index-aria-document">`document`</a>
2480-
or <a href="#index-aria-img">`img`</a>.
2485+
<a href="#index-aria-document">`document`</a>,
2486+
<a href="#index-aria-img">`img`</a>
2487+
or <a href="#index-aria-img">`image`</a>.
24812488
</p>
24822489
<p>
24832490
<a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and
@@ -4416,7 +4423,7 @@ <h2>
44164423
</tr>
44174424
<tr>
44184425
<th tabindex="-1" id="index-aria-img">
4419-
<a data-cite="wai-aria-1.2#img">`img`</a>
4426+
<a data-cite="wai-aria-1.2#img">`img` or `image`</a>
44204427
</th>
44214428
<td>
44224429
<ul>

0 commit comments

Comments
 (0)