Skip to content

Commit daade4f

Browse files
authored
Clarify menuitem[|radio|checkbox] menubar (#2171)
Closes #2140 Explicitly notes in second paragraph description for each of `menuitem`, `menuitemcheckbox` and `menuitemradio` that they are allowed in `menubar` as well as `menu`. Makes consistent with _Characteristics_ table for all 5 as well as final paragraph of description of first 3.
1 parent 6faab4c commit daade4f

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

index.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5214,7 +5214,7 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
52145214
<rdef>menuitem</rdef>
52155215
<div class="role-description">
52165216
<p>An option in a set of choices contained by a <rref>menu</rref> or <rref>menubar</rref>.</p>
5217-
<p>Authors MUST ensure [=elements=] with <a>role</a> <code>menuitem</code> are <a>accessibility children</a> of an element with role <rref>menu</rref> or an element with role <rref>group</rref> that is an <a>accessibility child</a> of an element with role <rref>menu</rref>.</p>
5217+
<p>Authors MUST ensure [=elements=] with <a>role</a> <code>menuitem</code> are <a>accessibility children</a> of an element with role <rref>menu</rref>, <rref>menubar</rref>, or an element with role <rref>group</rref> that is an <a>accessibility child</a> of an element with role <rref>menu</rref> or <rref>menubar</rref>.</p>
52185218
<p>Authors MAY disable a menu item with the <sref>aria-disabled</sref> attribute. If the menu item has its <pref>aria-haspopup</pref> attribute set to <code>true</code>, it indicates that the menu item can be used to launch a sub-level menu, and authors SHOULD display a new sub-level menu when the menu item is activated.</p>
52195219
<p>In order to identify that they are related <a>widgets</a>, authors MUST ensure that menu items are <a>accessibility descendants</a> of an element with role <rref>menu</rref> or <rref>menubar</rref>. Authors MAY separate menu items into sets by use of a <rref>separator</rref> or an element with an equivalent role from the native markup language.</p>
52205220
</div>
@@ -5323,7 +5323,7 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
53235323
<rdef>menuitemcheckbox</rdef>
53245324
<div class="role-description">
53255325
<p>A <rref>menuitem</rref> with a checkable state whose possible <span>values</span> are <code>true</code>, <code>false</code>, or <code>mixed</code>.</p>
5326-
<p>Authors MUST ensure [=elements=] with <a>role</a> <code>menuitemcheckbox</code> are <a>accessibility children</a> of an element with role <rref>menu</rref> or an element with role <rref>group</rref> that is the <a>accessibility child</a> of an element with role <rref>menu</rref>.</p>
5326+
<p>Authors MUST ensure [=elements=] with <a>role</a> <code>menuitemcheckbox</code> are <a>accessibility children</a> of an element with role <rref>menu</rref>, <rref>menubar</rref>, or an element with role <rref>group</rref> that is an <a>accessibility child</a> of an element with role <rref>menu</rref> or <rref>menubar</rref>.</p>
53275327
<p>The <sref>aria-checked</sref> <a>attribute</a> of a <code>menuitemcheckbox</code> indicates whether the menu item is checked (<code>true</code>), unchecked (<code>false</code>), or represents a sub-level menu of other menu items that have a mixture of checked and unchecked values (<code>mixed</code>).</p>
53285328
<p>In order to identify that they are related <a>widgets</a>, authors MUST ensure that menu item checkboxes are the <a>accessibility descendants</a> of an element with role <rref>menu</rref> or <rref>menubar</rref>. Authors MAY separate menu items into sets by use of a <rref>separator</rref> or an element with an equivalent role from the native markup language.</p>
53295329
</div>
@@ -5423,7 +5423,7 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
54235423
<rdef>menuitemradio</rdef>
54245424
<div class="role-description">
54255425
<p>A checkable <rref>menuitem</rref> in a set of elements with the same role, only one of which can be checked at a time.</p>
5426-
<p>Authors MUST ensure [=elements=] with <a>role</a> <code>menuitemradio</code> are <a>accessibility children</a> of an element with role <rref>menu</rref> or of an element with role <rref>group</rref> that is the <a>accessibility child</a> of an element with role <rref>menu</rref>.</p>
5426+
<p>Authors MUST ensure [=elements=] with <a>role</a> <code>menuitemradio</code> are <a>accessibility children</a> of an element with role <rref>menu</rref>, <rref>menubar</rref>, or an element with role <rref>group</rref> that is an <a>accessibility child</a> of an element with role <rref>menu</rref> or <rref>menubar</rref>.</p>
54275427
<p>Authors SHOULD enforce that only one <code>menuitemradio</code> in a group can be checked at the same time. When one item in the group is checked, the previously checked item becomes unchecked (its <sref>aria-checked</sref> <a>attribute</a> becomes <code>false</code>).</p>
54285428
<!-- keep previous sentence synced with radiogroup, etc. -->
54295429
<p>In order to identify that they are related <a>widgets</a>, authors MUST ensure that menu item radios are <a>accessibility descendants</a> of an element with role <rref>menu</rref> or <rref>menubar</rref>.</p>

0 commit comments

Comments
 (0)