Selection and input

TextField

Text input with a label, for secure entry and errors too.

iOSSwiftUI TextField / SecureFieldAndroidCompose OutlinedTextFieldRenders in a Screen or an Island

iOSSwiftUI TextField / SecureField

AndroidCompose OutlinedTextField

Import

import {TextField} from '@hzblj/kara-ui'

An uncontrolled text field with an optional label above it — SwiftUI TextField (SecureField when secure) / Compose OutlinedTextField.

Prop	Type	Default	Description
defaultValue	string	''	The text it starts with. Read once, on mount — the field is uncontrolled.
disabled	boolean	false	Stops editing and dims the field. On iOS it outranks `error`.
error	boolean	false	Marks the field invalid: a destructive outline and label.
label	string	—	Shown above the field, in `labelMedium`.
multiline	boolean	false	Wraps the text and grows the field to fit it. iOS ignores it when `secure`.
onChangeText	(text: string) => void	—	Called with the whole text after every change.
secure	boolean	false	Masks the text, for a password.
testID	string	—	iOS: forwarded to the native field. Android ignores it.

defaultValue''

string

The text it starts with. Read once, on mount — the field is uncontrolled.

disabledfalse

boolean

Stops editing and dims the field. On iOS it outranks error.

errorfalse

boolean

Marks the field invalid: a destructive outline and label.

label

string

Shown above the field, in labelMedium.

multilinefalse

boolean

Wraps the text and grows the field to fit it. iOS ignores it when secure.

onChangeText

(text: string) => void

Called with the whole text after every change.

securefalse

boolean

Masks the text, for a password.

testID

string

iOS: forwarded to the native field. Android ignores it.

Uncontrolled: start it with defaultValue and read changes from onChangeText.