Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
React Native docs
FormsReact Native

Segmented control

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

Public APILumenSegmentedControlReact Native

Native example

Use Segmented control

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

View verified React Native runtime capture
Segmented control rendered in the Expo web renderer Lumen playground
Verified runtime captureExpo web renderer
tsx
<LumenSegmentedControl
  label="View"
  options={viewOptions}
  value={view}
  onValueChange={setView}
/>

Reference

Public API

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

APIValues or typeDefaultDescription
labelStringRequiredNames the single-selection group.
optionsreadonly LumenSelectionOption[]RequiredProvides the short labeled segment values.
valuestringRequiredStores the selected value.
onValueChange(string) => voidRequiredUpdates the selected value.
showLabelBooleantrueControls visible label presentation while preserving the accessible group name.

Native behavior

Design and accessibility

When to use it

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

Accessibility

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

Shared component

Available on other platforms

Apple / SwiftUIAndroid / Compose
React Native docsNative primitives