FormsApple

Segmented control

Choose one value from a compact row of short peer options.

Public APILumenSegmentedControlApple / SwiftUISwift product: LumenUI

Apple availability

Supported native targets

Import LumenUI in the target that uses this component. iPad support follows the iOS package baseline and uses native iPad layout behavior.

iPhone · iOS 16+iPad · iPadOS 16+Mac · macOS 13+Apple Vision · visionOS 1+

Native example

Use for two to four short peer options that fit comfortably on one row. Use Radio group for longer labels, descriptions, or larger sets.

LumenSegmentedControl(
    "View",
    selection: $view,
    options: viewOptions
)

Reference

The primary shared and platform-specific options exposed by LumenSegmentedControl.

API	Values or type	Default	Description
label	`String`	`Required`	Names the single-selection group.
options	`[LumenSelectionOption<Value>]`	`Required`	Provides the short labeled segment values.
selection	`Binding<Value>`	`Required`	Stores the selected value.
onValueChange	`Binding setter`	`Required`	Updates the selected value.
showsLabel	`Boolean`	`true`	Controls visible label presentation while preserving the accessible group name.

Native behavior

Use for two to four short peer options that fit comfortably on one row. Use Radio group for longer labels, descriptions, or larger sets.

Segments expose radio-style single-selection semantics inside a named group while retaining selected and disabled state.

Shared component