Skip to content

Commit

Permalink
Editorial: Clarification of Combobox Role and aria-haspopup Attributes (
Browse files Browse the repository at this point in the history
#2134)

Closes #2132

The current specification text has two separate paragraphs describing the aria-haspopup attribute value requirements on a combobox—which are essentially the same. These have a conflict on the MUST use of aria-haspopup that pops up a Listbox. The proposed amendment aims to merge these paragraphs to enhance clarity, ensuring a clear understanding between the role combobox and the aria-haspopup values.

Co-authored-by: Scott O'Hara <[email protected]>
  • Loading branch information
LaurenceRLewis and scottaohara authored Mar 7, 2024
1 parent 77302e6 commit 7bfb796
Showing 1 changed file with 1 addition and 6 deletions.
7 changes: 1 addition & 6 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2060,12 +2060,7 @@ <h2>Definition of Roles</h2>
Authors MUST set <sref>aria-expanded</sref> to <code>true</code> on an element with role <code>combobox</code> when it is expanded and <code>false</code> when it is collapsed.
</p>
<p>
Authors MUST ensure the popup element associated with a <code>combobox</code> has a role of <rref>listbox</rref>, <rref>tree</rref>, <rref>grid</rref>, or <rref>dialog</rref>.
When the popup is displayed, authors MUST set <pref>aria-controls</pref> on a <code>combobox</code> element to a value that refers to the <code>combobox</code> popup element.
</p>
<p>
Elements with the role <code>combobox</code> have an implicit <pref>aria-haspopup</pref> value of <code>listbox</code>.
If the <code>combobox</code> popup element has a role other than <rref>listbox</rref>, authors MUST specify a value for <pref>aria-haspopup</pref> that corresponds to the role of its popup.
Elements with the role <code>combobox</code> have an implicit <pref>aria-haspopup</pref> value of <code>listbox</code>. If the <code>combobox</code> popup element has a role other than <rref>listbox</rref>, authors MUST specify an <pref>aria-haspopup</pref> value of <rref>tree</rref>, <rref>grid</rref>, or <rref>dialog</rref> that corresponds to the role of its popup.
</p>
<p>
If the user interface includes an additional icon that allows the visibility of the popup to be controlled via pointer and touch events, authors SHOULD ensure that element has role <rref>button</rref>, that it is focusable but not included in the page <kbd>Tab</kbd> sequence, and that it is not a descendant of the element with role <code>combobox</code>.
Expand Down

0 comments on commit 7bfb796

Please sign in to comment.