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.
Properties
Text Input
Property | Data Type | Description |
---|---|---|
Hint | text | The prompt text the user sees when the text input is empty (eg. |
Text | text | Populated text of the text input. |
Keyboard | select from list | 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. |
Secure Text Entry | true/false | Toggle whether the input text is obscured as a 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. |
Font Italic (web app only) | true/false | Select whether hint and text are shown in italics. |
Underline (web app only) | true/false | Select whether the hint and text are underlined. |
Strikethrough (web app only) | true/false | 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. |
Font Size | number in pixels | Set whether text should be written left-to-right or right-to-left. |
Letter Spacing | number 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 lines of text your user can enter. |
Clear Button Mode (iOS only) | select from list | 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 | 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:
On the Design tab, add a Text Input component to a screen.
Navigate to the Blocks tab.
In the component tree on the left, click the name of the text input component.
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.).
Last updated