Recorded

Changes in this version

Importance not yet assessed.

Adds guidance for touch input on Macs with a touch display across macOS pages

No section of this page changed in this version.

Other pages in this version: 18 sections on 6 pages. All pages changed in v35

Summaries are written automatically and may be wrong; the diff below is the record.

Combo boxes

People can enter a custom value into the field or click the button to choose from a list of predefined values. When people enter a custom value, it’s not added to the list of choices.

Best practices

Populate the field with a meaningful default value from the list. Although the field can be empty by default, it’s best when the default value refers to the hidden choices. The default value doesn’t have to be the first item in the list.

Use an introductory label to let people know what types of items to expect. Generally, use title-style capitalization for labels and end them with a colon. For related guidance, see Labels.

Provide relevant choices. People appreciate the ability to enter a custom value, as well as the convenience of choosing from a list of the most likely choices.

Make sure list items aren’t wider than the text field. If an item is too wide, the text field might truncate it, which is hard for people to read.

For guidance, see Text fields and Pull-down buttons.

Platform considerations

Not supported in iOS, iPadOS, tvOS, visionOS, or watchOS.

Resources

Text fields

Pull-down buttons

Developer documentation

NSComboBox — AppKit