Changes in this version
Developer guidance link renamed to "Creating custom SF Symbols" on symbol-related pages
No section of this page changed in this version.
Other pages in this version: 3 sections on 2 pages. All pages changed in v38
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
Related
Developer documentation
NSComboBox — AppKit