FormsAndroid

Text field

Collect a single line of text using each platform’s native input and focus behavior.

Public APILumenTextFieldAndroid / Compose

Native example

Use Text field

Keep a stable label even when placeholder text is present. Pair error styling with useful explanatory text rather than relying on color alone.

Text field rendered in the Android phone emulator Lumen playground — Verified runtime captureAndroid phone emulator

LumenTextField(
    value = email,
    onValueChange = { email = it },
    label = "Email address"
)

Reference

Public API

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

API	Values or type	Default	Description
value	`Bound String`	`Required`	Stores the current native input value.
onValueChange	`Value callback / binding`	`Required`	Updates application state.
label	`String`	`Required`	Names the field.
size	`sm · md · lg`	`md`	Selects shared control metrics.
error	`Boolean`	`false`	Applies the semantic invalid treatment.
enabled	`Boolean`	`true`	Controls native editing state.

Native behavior

Design and accessibility

When to use it

Keep a stable label even when placeholder text is present. Pair error styling with useful explanatory text rather than relying on color alone.

Accessibility

The field remains a native input with platform focus, keyboard, autofill, and screen-reader behavior. Errors use native invalid-state semantics where available.

Shared component

Available on other platforms

React Native Apple / SwiftUI