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 for a small set of related actions. Do not use it for single selection; use Segmented control or Radio group instead.

LumenButtonGroup {
    LumenButton("Save", action: save)
    LumenButton("Cancel", intent: .secondary, action: cancel)
}

Reference

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

API	Values or type	Default	Description
orientation	horizontal · vertical	horizontal	Prefers horizontal or vertical actions. Horizontal groups wrap or stack when space or accessibility text requires it.
content	Native buttons	Required	Provides independently operable actions.

Native behavior

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

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

Shared component