Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
LayoutApple

Button group

Lay out a small set of related native actions horizontally or vertically.

Public APILumenButtonGroupApple / 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 TV · tvOS 16+Apple Vision · visionOS 1+Apple Watch · watchOS 9+

Native example

Use Button group

Use for a small set of related actions. Do not use it for single selection; use Segmented control or Radio group instead.

Button group rendered in the iPhone simulator Lumen playground
Verified runtime captureiPhone simulator
swift
LumenButtonGroup {
    LumenButton("Save", action: save)
    LumenButton("Cancel", intent: .secondary, action: cancel)
}

Reference

Public API

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

APIValues or typeDefaultDescription
orientationhorizontal · verticalhorizontalControls action layout.
contentNative buttonsRequiredProvides independently operable actions.

Native behavior

Design and accessibility

When to use it

Use for a small set of related actions. Do not use it for single selection; use Segmented control or Radio group instead.

Accessibility

The group contains each native button without combining action names or changing activation behavior.

Shared component

Available on other platforms

React NativeAndroid / Compose
Apple docsSwiftUI package