Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

  • Where a preceding label is being used, the default text will be Select.

  • Where there is no label, the default text will be Select a {NameOfEntity}. For example, Select a queue.

Content

A combo box can have a preceding label (optional). Labels inform the user about what is included in the options list.

...

  • When the preceding label is not used, the default option should demonstrate the content of the list as much as possible.

  • Options can be ordered logically, alphabetically, numerically, or chronologically. Refer to the Drop-down Menu page for details.

  • The width of the options list should adapt to the longest option, up to a maximum width. Where options are too long they should be truncated with a tooltip displaying the full text shown on hover.

Internal Logic

Users need to either:

  • select one option exclusively from a short list, or

  • enter a custom value manually.

...

State

Input Field

Drop-down Arrow

Regular

Hover

Active

Disabled

Read-Only

Combo Box.pngImage Added

Error

Warning

Focused

Focused, Hover

Focused, Active

Focused, Disabled

...

Interaction

Details

Click the drop-down arrow

  • The options list is opened.

  • The text field is focused so that the user may start typing.

  • The user may use the Up and Down keys to navigate between options and Enter to select.

  • A blue check mark should be shown to the left of the selected option, where one exists.

Click the text field

  • The text field is focused and user can type.

  • The options list remains closed until characters are entered.

Enter characters in the text field

  • As characters are entered, the list is filtered to show matching results only.

  • The filter can match anywhere within the value string (at the beginning, middle, or end).

Select an option

On selecting an option:

  • the options list closes.

  • the selected option is displayed in the field.

Click anywhere outside of the combo box

  • Closes the options list.

Click Escape key

  • Closes the options list.

Validation & Errors

Please refer to the Field Validation page for more information.

A combo box with a warning:

...