FormsReact Native

Text field

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

Public APILumenTextFieldReact Native

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.

View verified React Native runtime capture

Text field rendered in the Expo web renderer Lumen playground — Verified runtime captureExpo web renderer

<LumenTextField
  accessibilityLabel="Email address"
  onChangeText={setEmail}
  value={email}
/>

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.
onChangeText	`Value callback / binding`	`Required`	Updates application state.
accessibilityLabel	`String`	`Required`	Names the field.
size	`sm · md · lg`	`md`	Selects shared control metrics.
error	`Boolean`	`false`	Applies the semantic invalid treatment.
editable	`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

Apple / SwiftUI Android / Compose