A text area is an area in which the user types or pastes one or multiple lines of text, without formatting the text. You can complete the Presentation tab while adding a Text area control.
|Edit Options|| Select an edit mode for this control. The edit mode of the control,
specified here, takes precedence over section and harness settings. |
|Read-only when|| Appears only when you select Read Only in the
Edit Options field. Enter or select one of the following: |
As a best practice, use the Condition Builder to edit this field. Click the Open condition builder icon to open the tool. See Using the Condition Builder to configure dynamic UI actions.
Select Auto if you want the layout to determine the width of the control area. This is the default. If you want to specify the width, select Custom and set the width in columns, pixels, or percent.
Select Auto if you want the layout to determine the height of the control area. This is the default. If you want to specify the height, you can select Size to Content, which means setting the minimum number of pixels or rows to display, or Custom to set the height in pixels or percent.
|Min/Max characters||Optional. Enter a value that determines the minimum and maximum number of characters that can be entered in the text input. You can designate either value as unlimited by leaving it blank.|
|Tooltip||If you want to display a tooltip when the user hovers the mouse pointer over the text input, press the down arrow to select the property that you want to display as a tooltip or type a text string within quotations, for example, "Select to open an item" .|
Select None if you do not want to display placeholder text.
Select Other if you want to display a hint or instructional text in the field. The text disappears when the user enters a value. If the user does not enter a value, the placeholder text reappears when the field loses focus.
Specifies the format of the text input. You can Skin form — Components tab — Controls — Text inputs & Formatted text and create additional formats in the skin rule. To select a custom format, press the down arrow and select Other.
Select a format (read-only) used with this property. Your selection filters the format options.
| DateTime Format |
|Text Alignment|| Appears if Type is |
Select left, right, or center alignment.
|Decimal Places|| Appears if Type is |
A non-negative integer to control the number of digits presented
after the decimal place. The default is
|Scale|| Appears if Type is |
Select a label indicating the scaling you wish to apply to the
number. The scales are K for thousands, M for millions, B for
billions, and T for trillions. For instance, if you select
|Negative Format|| Appears if the Type is |
Select a format (minus sign or parenthesis) for displaying negative numbers.
You can also specify a CSS class if you select one of the
|Symbol|| Appears if Type is |
Select an option for representing the number as
|Separators|| Appears if Type is |
Select to use a thousands' separator. Depending upon the default locale, a comma or period is used.
Appears if the Read-only format Type is Text.
|Auto Prepend|| Appears if Type is |
Select a property or constant that you want to add either before the displayed property value. For example, when the user name appears, the system can automatically prepend the user's title.
|Auto Append|| Appears if Type is |
Select a property or constant that you want to add after the displayed property value. For example, when the user name appears, the system can automatically append the full mail extension to the name.
|Show Value As|| Appears if the Type is |
Select to label either outcome using Text or an Image.
| True Image |
Appears if the Type is
Select an image to label either outcome. Used with a boolean type.
| True Text |
Appears if the Type is
Enter a text string to label either outcome. Used with a boolean type.
If the Localize? check box is selected on the section's HTML tab, a SmartPrompt Appears in the Constant field in the Parameters dialog. Select a field value rule if you plan to localize the text. If this text is to be localized, enter no more than 64 characters. A field value rule with pyCaption as the second key part and this text as the final key part is needed for each locale.
|Show validation messages in read-only mode|
- Adding a Text area control
A text area is an area in which the user types or pastes one or multiple lines of text, without formatting the text.