inputs/DSSelectField

DSSelectField

inputs

since 1.2.0

Dropdown menu that shows options and updates a binding with the selected value.

iOSmacOS

Purpose

Use for selecting a single option from a list. Displays selected value or placeholder, opens native menu on tap.

States

empty

No selection, shows placeholder in muted color

selected

Shows selected option title

error

Red border with error message below

Props

Prop	Type	Default	Description
label	String?	nil	Optional label above field
optionsreq	[(title: String, value: T)]	—	Array of title-value pairs
selectionreq	Binding<T?>	—	Binding to selected value
placeholder	String	"Select..."	Shown when no selection
error	String?	nil	Error message
hint	String?	nil	Helper text below field
accessibilityLabel	String?	nil	Optional accessibility label

Examples

Basic select

Simple dropdown with string options.

swift

@State var selectedCountry: String?

DSSelectField(
    label: "Country",
    options: [
        (title: "United States", value: "US"),
        (title: "Canada", value: "CA"),
        (title: "United Kingdom", value: "UK"),
    ],
    selection: $selectedCountry,
    placeholder: "Select country",
    hint: "Choose your country of residence"
)

With error state

Select field with validation error.

swift

DSSelectField(
    label: "Plan",
    options: planOptions,
    selection: $selectedPlan,
    error: selectedPlan == nil ? "Please select a plan" : nil
)

Usage Guidelines

Use for 3-15 options; consider alternative UI for longer lists
Provide clear, concise option labels
Use hint text to clarify what the selection affects
Show error state with validation messages

Related Components

TextField RadioGroup SegmentedControl