FormsAndroid

Settings row

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

Public APILumenSettingsRowAndroid / Compose

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 Android phone emulator Lumen playground — Verified runtime captureAndroid phone emulator

LumenSettingsRow(
    title = "Automatic updates",
    description = "Download stable updates automatically.",
    control = {
        LumenToggle(
            label = "Automatic updates",
            checked = automaticUpdates,
            showLabel = false,
            onCheckedChange = ::setAutomaticUpdates
        )
    }
)

Reference

Public API

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

API	Values or type	Default	Description
title	`String`	`Required`	Names the setting.
description	`String?`	`null`	Adds supporting explanation.
graphic	`(@Composable () -> Unit)?`	`null`	Adds an optional leading graphic.
control	`@Composable () -> Unit`	`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 Apple / SwiftUI