> For the complete documentation index, see [llms.txt](https://appmaster.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://appmaster.gitbook.io/docs/web-apps/components-list/input-text.md).

# Input (text)

Input field for text

## **Look\&Feel Settings:**

**Label** (not mandatory) - label for input.

**Placeholder** (not mandatory) - placeholder for input.

**Name** (mandatory) - name of the input.

**Tooltip** (not mandatory) - hint for input.

**Min rows** (not mandatory) - min number of lines to enter

**Max rows** (not mandatory) - max number of lines to enter

**Required** (mandatory) - makes the field mandatory. Disabled by default.

**Allow clear** (mandatory) - icon to clear the input. Disabled by default.

**Validate icon** (mandatory) - validate icon for input. Disabled by default.

**Disabled** (mandatory) - makes the component disabled if turned on. Is turned off by default.

**Visible** (mandatory) - makes the component visible if turned on. Enabled by default.

![](https://3563768697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MapxHzVskQ_27pNUTT4-1972196547%2Fuploads%2FrTeyvEQV1I8gp6J6I6wq%2Fimage.png?alt=media\&token=6c83510a-0dd8-4a2c-a987-f6baa7fc3ae3)

## **Workflow triggers:**

* **onCreate** – fires when the element is created on the page; 
* **onShow** – fires when the component changes its state to visible (displayed on the page); 
* **onHide** – fires when the component changes its state to hidden (stops being displayed); 
* **onDestroy** – fires before the component is destroyed;
* **onChange** - fires when the value is changed;
* **onFocus** - fires when component is being focused;
* **onBlur** - fires when component is blurred**.**

## Component Actions

### InputText Get Properties

Gets the component's properties.

**Input** parameters:

* **Component Id** \[string] *-* input component's identifier.

**Output** parameters:

* **Label** \[*string*] - input label;
* **Placeholder** \[*string*] - input placeholder;
* **Allow clear** \[*boolean*] - state of allow clear;
* **Disable** \[*boolean*] - disables component if *true*;
* **Visible** \[*boolean*] - component visibility state;
* **Tooltip** \[*string*] - input field hint;
* **Min row** \[*integer*] - min number of lines to enter**;**
* **Max row** \[*integer*] - max number of lines to enter;
* **Required** \[*boolean*] - shows required mark if *true*;
* **Debounce** (ms) \[*integer*] - delay to validate the value; 
* **Value** \[*text*] - value from input;
* **Validate Icon** \[*boolean*] - icon to be shown on validate the value;
* **Validate Status** \[*Status type*] - status to be shown on validate the value; 
* **Validate Message** \[*string*] - message to be shown on validate the value.

![](https://3563768697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MapxHzVskQ_27pNUTT4-1972196547%2Fuploads%2Ff17U3hMcHgncd2LOs1Ce%2Fimage.png?alt=media\&token=76d03c09-bf43-476b-96cd-c97d92ced7a7)

### InputText Set Properties

Sets the component's properties.

**Input** parameters:

* **Component Id** \[string] *-* input component's identifier;
* **Label** \[*string*] - input label;
* **Placeholder** \[*string*] - input placeholder;
* **Allow clear** \[*boolean*] - state of allow clear;
* **Disable** \[*boolean*] - disables component if *true*;
* **Visible** \[*boolean*] - component visibility state;
* **Tooltip** \[*string*] - input field hint;
* **Required** \[*boolean*] - shows required mark if *true*;
* **Debounce** (ms) \[*integer*] - delay to validate the value; 
* **Value** \[*text*] - value from input;
* **Validate Icon** \[*boolean*] - icon to be shown on validate the value;
* **Validate Status** \[s*tatus type*] - status to be shown on validate the value; 
* **Validate Message** \[*string*] - message to be shown on validate the value.

![](https://3563768697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MapxHzVskQ_27pNUTT4-1972196547%2Fuploads%2FlBnlZrWB3pbWkYSRHQqY%2Fimage.png?alt=media\&token=aaaf15cd-531e-487a-a0ad-1ca50efdd7ee)

### InputText Update Properties

Update the component's properties.

**Input** parameters:

* **Component Id** \[string] *-* input component's identifier;
* **Label** \[*string*] - input label;
* **Placeholder** \[*string*] - input placeholder;
* **Allow clear** \[*boolean*] - state of allow clear;
* **Disable** \[*boolean*] - disables component if *true*;
* **Visible** \[*boolean*] - component visibility state;
* **Tooltip** \[*string*] - input field hint;
* **Required** \[*boolean*] - shows required mark if *true*;
* **Debounce** (ms) \[*integer*] - delay to validate the value; 
* **Value** \[*text*] - value from input;
* **Validate Icon** \[*boolean*] - icon to be shown on validate the value;
* **Validate Status** \[s*tatus type*] - status to be shown on validate the value; 
* **Validate Message** \[*string*] - message to be shown on validate the value.

![](https://3563768697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MapxHzVskQ_27pNUTT4-1972196547%2Fuploads%2FZPRSvfHNUfDtmhQgmqm2%2Fimage.png?alt=media\&token=505e2ff7-ef56-4a94-8b53-26cdef3ac6a1)

## Usage example

The input text is suitable for giving the user the opportunity to write a detailed message, for example, a comment:

![](https://3563768697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MapxHzVskQ_27pNUTT4-1972196547%2Fuploads%2Fwr9wJtRXANZsqxbXsuVk%2Fimage.png?alt=media\&token=056106a7-6f06-4498-bab5-2dcec73a198e)