FormsApple

Settings row

Align a setting title and explanation with an optional graphic and trailing native control.

Public APILumenSettingsRowApple / 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 Settings row

Use to align repeated settings rows. The trailing content should be a compact native control rather than unrelated actions.

Settings row rendered in the iPhone simulator Lumen playground — Verified runtime captureiPhone simulator

LumenSettingsRow(
    "Automatic updates",
    description: "Download stable updates automatically.",
    systemName: "arrow.triangle.2.circlepath"
) {
    LumenToggle("Automatic updates", isOn: $automaticUpdates)
        .labelsHidden()
}

Reference

Public API

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

API	Values or type	Default	Description
title	`LocalizedStringKey`	`Required`	Names the setting.
description	`LocalizedStringKey?`	`nil`	Adds supporting explanation.
systemName	`SF Symbol name?`	`nil`	Adds an optional leading graphic.
control	`@ViewBuilder () -> Control`	`Required`	Provides the trailing native control.

Native behavior

Design and accessibility

When to use it

Use to align repeated settings rows. The trailing content should be a compact native control rather than unrelated actions.

Accessibility

The explanatory copy and trailing control remain contained while the control preserves independent focus and semantics.

Shared component

Available on other platforms

React Native Android / Compose