# Text Input Component ## Overview The text input component is a field where app users can enter text, such as a name or email address.

## Video Tutorial ### How to Implement Text Input Validation in Thunkable In this tutorial, we’ll implement text input validation to disable a button until text input conditions are met. {% embed url="" %} {% hint style="warning" %} You need to make your screen scrollable to prevent the text input from moving up when the keyboard appears. {% endhint %} ## Properties ### Text Input

Property	Data Type	Description	Description
Hint	text	The prompt text the user sees when the text input is empty (eg. `Type Email`).	The prompt text the user sees when the text input is empty (eg. `Type Here`).
Text	text	Populated text of the text input.	Populated text within the text input.
Keyboard	select from list `[default, email address, numeric, phone pad]`	The keyboard style provided to a user when they tap into the text input. If none are selected, it will be the default standard keyboard.	Select the type of keyboard provided to your user when they click into the text input field. If n
Secure Text Entry	true/false	Toggle whether the input text is obscured as a user types (suitable for entering passwords and other sensitive information).	Toggle whether text is obscured as your end user types (suitable for entering passwords and other sensitive information)
Font	text	Set the font for the hint and text properties. Options can be found here: Google Fonts.	Set the font for the Hint and Text properties. Options can be found here: Google Fonts.
Font Italic (web app only)	true/false	Select whether hint and text are shown in italics.	Select whether hint and text are shown in italics.
Underline (web app only)	true/false	Select whether the hint and text are underlined.	Select whether the hint and text are underlined.
Strikethrough (web app only)	true/false	Apply strikethrough formatting to the hint and text.	Apply strikethrough formatting to the hint and text.
Writing Direction (iOS and web app only)	select from icons	Set whether text should be written left-to-right or right-to-left.	Set whether text should be written left-to-right or right-to-left.
Font Size	number in pixels	Set whether text should be written left-to-right or right-to-left.	Height of hint and text in pixels.
Letter Spacing	number in pixels	Spacing between letters in pixels.	Spacing between letters in pixels.

### Advanced Properties

Property	Value	Description
Editable	true/false	Toggle whether the user can edit the text.
Multiline	true/false	Toggle whether the user can enter multiple lines of text.
Auto Focus	true/false	Toggle whether the text input field is automatically in focus when the screen opens (i.e. the user doesn't need to tap into the field to focus).
Max Length (Android and iOS only)	number	Set the maximum number of characters of text your user can enter. Mobile only
Clear Button Mode (iOS only)	select from list `[never, while-editing, unless-editing, always]`	Toggle when an iOS user has the option to clear the text input's text.
Input Color	Color	The color of the text input's text.
Background Color	color	The background color of the text input field.
Hint Text Color	color	The color of the text input's hint.
Selection Color (Android and iOS only)	color	The highlight color when a user selects a section of text.

### Layout

Property	Value	Description
X	coordinate value	Position of the upper left corner of the text input on the X-axis, where the left side of the screen is X=0.
Y	coordinate value	Position of the upper left corner of the text input on the Y-axis, where the top of the screen is Y=0.
Height	number in pixels	The text input's height is defined by a custom number of pixels.
Width	number in pixels	The text input's width is defined by a custom number of pixels.
Resize Mode	Stretch	Stretches the text input to fit the dimensions of the device's screen.
Resize Mode	Float in Place	Renders the text input in the same aspect ratio as the design, regardless of the device size.

### Style

Property	Value	Description
Visible	true/false	Toggle whether users can see the text input.
Border Style	select from list `[solid, dotted, dashed]`	Style of text input's border.
Border Color	color	Color of text input's border.
Border Width	number in pixels	The width of the text input's border is defined by a custom number of pixels.
Border Radius	number in pixels	The radius of the text input's border’s corners is defined by a custom number of pixels.
Shadow Color	color	The text input's shadow is the color selected.
Shadow Opacity	number between 0 and 100	The opacity of the text input's shadow.
Shadow Radius	number in pixels	The radius of the text input's shadow’s corners is defined by a custom number of pixels.
Shadow Offset	number in pixels	How far the text input's shadow should be offset, in height and width, is defined by a custom number of pixels.

## Text Input Blocks To access the blocks specific to the text input component: 1. On the Design tab, add a **Text Input** component to a screen. 2. Navigate to the **Blocks** tab. 3. In the component tree on the left, click the name of the text input component. 4. A drawer of text input-specific blocks opens. ### Event Blocks #### When Text Input Click This event fires when the user clicks on the text input component.

#### When Text Input Unfocus This event fires when the component loses focus, i.e. the user clicks on another component.

#### When Text Input Submit This event fires when the enter or submit button is pressed on the device keyboard.

#### When Text Input Changes This event fires whenever a character is added to or removed from the text input (i.e. whenever there is a change to the content of the text input).

### Properties Blocks There are two types of property blocks: dark green "set" and light green "get" blocks. The specific blocks available vary according to the UI component. The dark green set blocks allow you to change the component's properties using blocks. For example, if you don't want a button to be enabled for a user until they've typed a set number of characters into a text input component, you can use the button's dark green set button's disabled status block. The light green get blocks allow you to access the properties of a component (e.g. color, font, width, text, etc.).