Skip to main content

TextInput

TextInput is the app-level text-entry control. It displays the current text or placeholder, applies focus styling, can show icons, and opens the configured keyboard flow when selected.

Key Fields​

  • text: current value.
  • isActive: whether the input responds to selection.
  • placeholderText: placeholder shown when empty.
  • inputType: Text, Password, or other TextInputType values.
  • backgroundColor, backgroundUri, focusIndicatorUri, focusIndicatorColor.
  • iconUri, iconColor, iconSize.
  • onTextChange: called when the keyboard dialog returns updated text.
  • inputErrorHint: optional error copy.

Example​

TextInput({
  text: this.email,
  placeholderText: 'Email address',
  inputType: TextInputType.Email,
}).onTextChange(event => {
  this.email = event.text;
});

Use TextEditBox when you need a direct native text-edit node instead of the composed input experience.