FormsAndroid

Field group

Compose related native controls under one label, description, required state, and validation message.

Public APILumenFieldGroupAndroid / Compose

Native example

Use Field group

Use when several controls share one label or validation message. Do not use it to duplicate a label already owned by one Text field or Textarea.

Field group rendered in the Android phone emulator Lumen playground — Verified runtime captureAndroid phone emulator

LumenFieldGroup(
    label = "Notification channels",
    description = "Choose every channel the team should use.",
    required = true
) {
    NotificationControls()
}

Reference

Public API

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

API	Values or type	Default	Description
label	`String`	`Required`	Names the grouped field controls.
description	`String?`	`nil`	Adds shared supporting guidance.
errorMessage	`String?`	`nil`	Adds a shared validation message.
required	`Boolean`	`false`	Shows that the grouped answer is required.
content	`Native content`	`Required`	Provides independently accessible controls.

Native behavior

Design and accessibility

When to use it

Use when several controls share one label or validation message. Do not use it to duplicate a label already owned by one Text field or Textarea.

Accessibility

The label and messages provide context without merging the semantics of contained native controls or their actions.

Shared component

Available on other platforms

React Native Apple / SwiftUI