The Text Area Web Control captures a longer strings of text than the Text Input Web Control. It is used to capture longer sentences or paragraphs.
Properties
General
Placeholder Text
Expects type text
.
The text that is displayed in the input’s box until the user starts typing.
Data Binding
Value
Expects type text
.
By default, this Data Binding property auto-generates a Variable of type Text at the Web Page level to store the data from the input. Users can also edit the Data Binding property and create their own Variables.
Data Tag
Assigns a data tag on the value of the control. For more information, see Data Masking and Auditing.
More
Maximum Length
Expects type number
.
Determines the maximum number of characters for the input.
Accessibility
Aria Label
Expects type text
.
The aria-label attribute is used to define a string that labels the current element. It is used to provide an accessible name for the control. For more information see here
Input ID
Expects type text
.
The Input ID assigned to the Text Area Web Control. This Input ID can tied to a Label so that clicking on the associated Label will allow users to enter Text input.
For more on how to use the Input ID, see Connecting Labels to Input Controls.
State
Is Visible
Expects type boolean
.
If TRUE
the control will be visible. If FALSE
the control will not be displayed. If the field is empty, the control will be visible.
Is Disabled
Expects type boolean
.
If TRUE
the control will be disabled and the user will not be able to interact with the control. If FALSE
the control will be enabled. If the field is empty, the control will be enabled.
Style
This control Variant has styles for the following states:
Default - When first rendered without state
Focused - when the control is focused
Disabled - When the control is disabled
Check Common style properties of web controls for further details on how to style this Web Control.
Actions
On Blur
Triggers when the user leaves the input field. That is, when changing the focus from the field to some other part of the application.
Value Changed
Triggers with each typed character. That is the Value changes every time a key is pressed, unlike a Checkbox, where its Value changes when the box is selected.
Example
The Text Area Input can be used when asking App users to leave comments: