Configure Text Input and Area Fields

A text input control allows users to enter short, single line text entries. A text area control allows users to enter longer, multi-line text entries. In a text area control, as a user enters multi-line text, if needed, a scroll bar appears to scroll down and view the entire text.

To configure a text input or a text area control:
  1. From the Basic Palette, drag the Input text control or the Text Area control onto the canvas.
  2. Select the control and edit its properties on the Properties pane's General tab.
    Field Description

    Name

    An internal identifier that you will use to identify the control.

    Binding

    Defines a link between the control and a data attribute.

    Computed Value

    Set this property to apply a computation to the control. See Create Computed Controls.

    Placeholder

    Text that will appear in the control until any text is entered. If text is removed from the control, the text specified in this field reappears.

    Hint

    Hint text that will display to users when a user clicks into the control.

    Help

    Help text that will appear for the control. If you specify help text, a help icon appears next to the name of the control and displays the help text when a user hovers over it or clicks it.

    Min Length

    Defines the minimum number of characters a user must enter into the control. Leave this field blank if you don't want to define the minimum length.

    Max Length

    Defines the maximum number of characters a user can enter into the control.

    Rows

    Defines the number of text rows that will be visible to a user. A scroll bar appears automatically when the number of text rows entered by the user is greater than the value specified in this field.

    Pattern

    Allows you to define custom validations on the type of text a user enters into the control. Enter a pattern using regular expressions. When you specify a pattern for the control, you can also specify a message in the Pattern Validation Message field that will display if the validation fails.

    Password

    Allows you to create a secure text field that masks the characters entered into it.

    Events

    Allows you to configure events for the control. You can assign actions or If/Then/Else conditions to the control based on a selected event. See Add Dynamic Behavior to Forms.

  3. On the Styling tab, edit the control's styling properties.
  4. Click Preview to try out using the control.