Skip to content

Commit

Permalink
Combobox Pattern: Simplify wording of description in "About This Patt…
Browse files Browse the repository at this point in the history
…ern" section (pull #2733)

On the combobox pattern page, in the "About This Pattern" section, revises the first two paragraphs of the description of a combobox.
  • Loading branch information
mcking65 committed Jul 10, 2023
1 parent 114ae45 commit e716cc2
Showing 1 changed file with 6 additions and 3 deletions.
9 changes: 6 additions & 3 deletions content/patterns/combobox/combobox-pattern.html
Original file line number Diff line number Diff line change
Expand Up @@ -19,17 +19,20 @@ <h1>Combobox Pattern</h1>
<section id="about">
<h2>About This Pattern</h2>
<p>
A <a href="#combobox" class="role-reference">combobox</a> is an input widget with an associated popup that enables users to select a value for the combobox from a collection of possible values.
In some implementations, the popup presents allowed values, while in other implementations, the popup presents suggested values, and users may either select one of the suggestions or type a value.
A <a href="#combobox" class="role-reference">combobox</a> is an input widget that has an associated popup.
The popup enables users to choose a value for the input from a collection.
The popup may be a <a href="../listbox/listbox-pattern.html">listbox</a>, <a href="../grid/grid-pattern.html">grid</a>, <a href="../treeview/treeview-pattern.html">tree</a>, or <a href="../dialog-modal/dialog-modal-pattern.html">dialog.</a>
</p>
<p>
In some implementations, the popup presents allowed values, while in other implementations, the popup presents suggested values.
Many implementations also include a third optional element -- a graphical <q>Open</q> button adjacent to the combobox, which indicates availability of the popup.
Activating the <q>Open</q> button displays the popup if suggestions are available.
</p>
<p>
The combobox pattern supports several optional behaviors.
The one that most shapes interaction is text input.
Some comboboxes allow users to type and edit text in the combobox and others do not.
If a combobox does not support text input, it is referred to as select-only, meaning the only way users can set a value is by selecting a value in the popup.
If a combobox does not support text input, it is referred to as select-only, meaning the only way users can set its value is by selecting a value in the popup.
For example, in some browsers, an HTML <code>select</code> element with <code>size="1"</code> is presented to assistive technologies as a combobox.
Alternatively, if a combobox supports text input, it is referred to as editable.
An editable combobox may either allow users to input any arbitrary value, or it may restrict its value to a discrete set of allowed values, in which case typing input serves to filter suggestions presented in the popup.
Expand Down

0 comments on commit e716cc2

Please sign in to comment.