Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
FormsApple

Radio group

Choose one value from a visible, labeled group of native radio options.

Public APILumenRadioGroupApple / 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 Radio group

Use when every option should remain visible and supporting descriptions help the decision. Use Segmented control for a small compact peer set.

Radio group rendered in the iPhone simulator Lumen playground
Verified runtime captureiPhone simulator
swift
LumenRadioGroup(
    "Density",
    selection: $density,
    options: densityOptions
)

Reference

Public API

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

APIValues or typeDefaultDescription
labelStringRequiredNames the single-selection group.
options[LumenSelectionOption<Value>]RequiredProvides labeled values with optional descriptions and disabled state.
selectionBinding<Value>RequiredStores the selected value.
onValueChangeBinding setterRequiredUpdates the selected value.

Native behavior

Design and accessibility

When to use it

Use when every option should remain visible and supporting descriptions help the decision. Use Segmented control for a small compact peer set.

Accessibility

Options expose native radio semantics inside a named single-selection group, including selected and disabled states.

Shared component

Available on other platforms

React NativeAndroid / Compose
Apple docsSwiftUI package