Configure Text Input and Area Fields

A text input control allows users to enter short, single-line text, such as name or email. A text area control allows users to enter longer, multi-line text entries, such as comments and descriptions.

To configure a text input or a text area control:
  1. From the Basic palette, drag an Input text or a Text Area control onto the canvas.
  2. Select the control and use the General tab in the Properties pane to configure the following:
    Field Description

    Name

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

    Label

    Specifies the name that displays to users.

    Binding

    Defines a link between the control and a data attribute.

    Placeholder

    The default text that will appear in the control until any text is entered by the user.

    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.

    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.

    This option is only available for text area controls.

    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, you can also specify a message in the Pattern Validation Message field that will display if the validation fails.

    This option is only available for text input controls.

    Required

    Select this property to specify that users must provide a value in order to successfully submit the form. An asterisk displays to indicate that it's a required field.

    Autocomplete

    Select this property to display autocompletion entries when users begin to enter text into the control.

    Disabled

    Select this property to display the control as inactive (grayed out) to users.

    Auto Focus

    Select this property to automatically focus on this control when the form loads. If multiple controls are set to Auto Focus, the focus goes to the first control in the form.

    Read Only

    Select this property to display the control's content (if any) without allowing users to edit it.

    Hide

    Select this property to hide the control.

    Password

    Select this property to create a secure text field that masks the characters entered into it.

    Automatic Height

    Select this property to automatically adjust the height of the control to fit content. This option is available only for text area controls.

  3. Use the Styling tab in the Properties pane to modify the control’s appearance as needed. See Styling Properties.