TextInput API

API reference docs for theTextInputcomponent. For examples and details on the usage of this component, visit the component demo page.

Props

Prop

Type

Description

Default

adornmentStart?

React.ReactNode

Slot to render start adornment.

_

adornmentEnd?

React.ReactNode

Slot to render end adornment

_

aria-activedescendant?

string

Identifies the currently active element when DOM focus is on the text input.

_

aria-autocomplete?

"none" | "inline" | "list" | "both"

Indicates whether inputting text field can show suggested values and how those suggestions appear.

_

aria-controls?

string

Identifies the element(s) that the text input controls.

_

aria-expanded?

boolean

Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed.

_

aria-haspopup?

boolean [ "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" ]

Indicates the availability of a popup related to the text input.

_

autoComplete?

string

Indicates if autocomplete is enabled for the input field.

_

autoCorrect?

'on' | 'off'

Indicates if auto-correction is turned on for the input.

_

autoFocus?

boolean

Automatically sets focus on the input field when it appears

_

defaultValue?

string | number | readonly string[] | undefined

The initial value of the text input.

_

disabled?

boolean

When true, the input becomes uneditable, makes it read-only, and blocks interaction.

false

inputMode?

"none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined

It specifies the type of virtual keyboard to display, helping users enter the correct type of data more easily.

_

name?

string | undefined

Identifier for the input, used in form submissions.

_

onBlur?

function

A function that executes when the input loses focus.

_

onChange?

function

A function that executes when the input's value changes.

_

onFocus?

function

A function that triggered when the input receives focus.

_

onKeyDown?

function

A function that called when a key is pressed while the input is focused.

_

onClick?

function

A function that called when Textinput is clicked.

_

onPaste?

function

A function that executes when content is pasted into the input.

_

pattern?

string

Regular expression pattern the input's value must match for validation.

_

placeholder?

string

Placeholder text displayed when the input is empty.

_

role?

string

ARIA role for the input.

_

spellCheck?

boolean

Indicates if the input value should be checked for spelling errors.

_

type?

'email' | 'password' | 'search' | 'tel' | 'text' | 'url'

Type of the input element.

_

value?

string | number | readonly string[] | undefined

Defines the default or current value of the input field.

_

focusContainerRef?

React.Ref<HTMLDivElement>

Reference to the wrapper FocusContainer element.

_