FormsReact Native

Field group

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

Public APILumenFieldGroupReact Native

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.

View verified React Native runtime capture

Field group rendered in the Expo web renderer Lumen playground — Verified runtime captureExpo web renderer

<LumenFieldGroup
  label="Notification channels"
  description="Choose every channel the team should use."
  required
>
  <NotificationControls />
</LumenFieldGroup>

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

Apple / SwiftUI Android / Compose