Skip to content

Commit f7ed5ff

Browse files
authored
Clarify li element role allowances (#410)
* update li element's implicit role mappings to reflect html aam * redraft li rule - fix typo - clarify role rules further * update changelog
1 parent 4d9fc05 commit f7ed5ff

File tree

1 file changed

+29
-16
lines changed

1 file changed

+29
-16
lines changed

index.html

Lines changed: 29 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,11 @@
6363
the following substantive additions and/or corrections have been proposed:
6464
</p>
6565
<ul>
66+
<li>
67+
<a href="https://github.com/w3c/html-aria/pull/410">31 May 2023 - Correction:</a>
68+
Update <a href="#el-li">`li`</a> element role allowances in context to the element's ancestral relationship, or lack of,
69+
to a list element parent.
70+
</li>
6671
<li>
6772
<a href="https://github.com/w3c/html-aria/pull/401">24 March 2023 - Addition:</a>
6873
The <a href="#el-search">`search`</a> element has been added.
@@ -73,7 +78,7 @@
7378
</li>
7479
<li>
7580
<a href="https://github.com/w3c/html-aria/pull/415">13 February 2023 - Addition:</a>
76-
Update `figure` element role allowances to include `doc-example`.
81+
Update `figure` element role allowances to include `doc-example`.
7782
</li>
7883
<li>
7984
<a href="https://github.com/w3c/html-aria/pull/437">07 November 2022 - Correction:</a>
@@ -469,7 +474,7 @@ <h2 id="docconformance">
469474
</p>
470475
</th>
471476
<th>
472-
ARIA roles, states and properties which MAY be used
477+
ARIA role, state and property allowances
473478
</th>
474479
</tr>
475480
</thead>
@@ -2127,24 +2132,32 @@ <h2 id="docconformance">
21272132
<th id="el-li" tabindex="-1">
21282133
[^li^]
21292134
</th>
2130-
<td>
2131-
<code>role=<a href="#index-aria-listitem">listitem</a></code>
2132-
</td>
21332135
<td>
21342136
<p>
2135-
Roles:
2136-
<a href="#index-aria-menuitem">`menuitem`</a>,
2137-
<a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>,
2138-
<a href="#index-aria-menuitemradio">`menuitemradio`</a>,
2139-
<a href="#index-aria-option">`option`</a>,
2140-
<a href="#index-aria-none">`none`</a>,
2141-
<a href="#index-aria-presentation">`presentation`</a>,
2142-
<a href="#index-aria-radio">`radio`</a>,
2143-
<a href="#index-aria-separator">`separator`</a>,
2144-
<a href="#index-aria-tab">`tab`</a>
2145-
or <a href="#index-aria-treeitem">`treeitem`</a>. (<code><a href="#index-aria-listitem">listitem</a></code> is also allowed, but NOT RECOMMENDED.)
2137+
If the `li` is a child of a list element
2138+
(<a href="#el-ul">`ul`</a>, <a href="#el-ol">`ol`</a>,
2139+
<a href="#el-menu">`menu`</a>)
2140+
<code>role=<a href="#index-aria-listitem">listitem</a></code>.
21462141
</p>
21472142
<p>
2143+
Otherwise, if the `li` is not a child of a list element it is exposed as
2144+
a <code>role=<a href="#index-aria-generic">generic</a></code>.
2145+
</p>
2146+
</td>
2147+
<td>
2148+
<div class="proposed correction">
2149+
<p>
2150+
<strong class="nosupport"><a>No `role`</a></strong> other than <code><a href="#index-aria-listitem">listitem</a></code>, which is NOT RECOMMENDED,
2151+
if the parent list element has an implicit or explicit `list` role.
2152+
</p>
2153+
<p>
2154+
Otherwise, <a><strong>any `role`</strong></a> if the parent list item does nto expose an implicit or explicit `list` role.
2155+
</p>
2156+
<p class="note">
2157+
See <a href="#el-ul">`ul`</a>, <a href="#el-ol">`ol`</a>, or
2158+
<a href="#el-menu">`menu`</a> for allowed roles for list elements.
2159+
</p>
2160+
</div>
21482161
<p>
21492162
<a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a>
21502163
and any `aria-*` attributes applicable to the allowed roles.

0 commit comments

Comments
 (0)