TextField
Observes enabled for TextField at the next owner-thread frame cutoff.
Retain caller-owned sources and editing state outside reevaluation. See Observe for shared snapshots, equal-value suppression, and cleanup; literal arguments follow TextField. Modifiers and parent data apply to the actual component, while the binding owns its sibling key.
Emits one 200 by 20 single-line text field.
Editing preserves Unicode scalars while TextFieldState.maxLength counts UTF-16 code units. Delivered preedit text remains inline presentation state until committed input arrives. The component does not install a platform candidate window or add selection and clipboard commands.
Receiver
active owner-thread screen scope.
Parameters
owner-thread text value observed by the retained field.
whether focus and editing are accepted.
profile-backed glyph style.
active behavior applied to the field.
optional stable sibling identity.
Throws
when the scope or state thread is invalid or no runtime evaluation is active.
Emits one explicitly sized single-line text field.
Receiver
active owner-thread screen scope.
Parameters
owner-thread text value observed by the retained field.
exact logical field extent.
whether focus and editing are accepted.
profile-backed glyph style.
active behavior applied to the field.
optional stable sibling identity.
Throws
when size cannot contain the field or later constraints exclude it.
when the scope or state thread is invalid or no runtime evaluation is active.
Emits one 200 by 20 single-line text field using an explicitly selected resource-pack font.
Receiver
active owner-thread screen scope.
Parameters
caller-owned text value observed by the retained field.
structural identifier of the font definition.
whether focus and editing are accepted.
profile-backed color and shadow policy.
active behavior applied to the field.
optional stable sibling identity.
Throws
when the scope or state thread is invalid or no runtime evaluation is active.
Emits one explicitly sized single-line text field using a selected resource-pack font.
The selected font supplies both drawing and cursor metrics from the runtime's pinned resource state. Movement and deletion operate on Unicode scalars, not grapheme clusters, and TextFieldState.maxLength remains a UTF-16 bound.
Receiver
active owner-thread screen scope.
Parameters
caller-owned text value observed by the retained field.
exact logical field extent.
structural identifier of the font definition.
whether focus and editing are accepted.
profile-backed color and shadow policy.
active behavior applied to the field.
optional stable sibling identity.
Throws
when size cannot contain the field or later constraints exclude it.
when the scope or state thread is invalid or no runtime evaluation is active.
Emits a retained TextField with a per-editor appearance. Geometry, state ownership, font, wrapping, and input behavior follow the corresponding ordinary overload. Appearance images are resolved at evaluation; invalid nine-slice borders fail before a frame is presented. Keep state and images outside reevaluated content. Appearance-only changes preserve focus, composition, and scroll. Use TextStyle.ContainerLabel for dark text on light frames; the appearance controls caret and composition colors.
Throws
when the installed runtime lacks custom appearance support.