Skip to content

Commit

Permalink
pulling in more feedback
Browse files Browse the repository at this point in the history
imo, the prior suggestions went a bit beyond scope for what I think was needed for this update.  So I pulled in some of the suggested updates, but not all.
  • Loading branch information
scottaohara authored Dec 9, 2024
1 parent a42d477 commit f43f763
Showing 1 changed file with 2 additions and 1 deletion.
3 changes: 2 additions & 1 deletion index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5289,7 +5289,8 @@ <h4>Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula</h4>
<rdef>menu</rdef>
<div class="role-description">
<p>A type of <a>widget</a> that offers a list of choices to the user.</p>
<p>A menu is a popup list of items that represent a set of actions or functions a user can invoke. The menu and list of <code>menuitems</code> are almost always directly related to the item that the user interacted with to reveal the menu. The <code>menu</code> <a>role</a> is appropriate when a list of menu items is presented in a manner similar to a menu on a desktop application. For instance, a menu could be used to represent a context menu for its invoking element, or it would be used to render sub-menus for items of a <rref>menubar</rref> or another <code>menu</code> popup.</p>
<p>A menu is container, generally visually rendered as a popup or overlay, for a set of menu items that can be invoked to perform an action or function. The function is almost always directly related to the element, or a close relation to the element that the user activated to invoke the menu. Activating a menu item both performs the function, and results in the automatic dismissal of the menu.</p>
<p>The <code>menu</code> <a>role</a> is appropriate when a set of menu items is presented in a manner similar to a popup menu for a desktop application. For instance, a menu could be used to represent a context menu for its invoking element, or it would be used to render sub-menus for items of a <rref>menubar</rref> or another <code>menu</code> popup.</p>
<p>To be <a>keyboard accessible</a>, authors SHOULD manage focus of descendants for all instances of this <a>role</a>, as described in <a href="#managingfocus">Managing Focus</a>.</p>
<p>Elements with the role <code>menu</code> have an implicit <pref>aria-orientation</pref> value of <code>vertical</code>.</p>
</div>
Expand Down

0 comments on commit f43f763

Please sign in to comment.