Skip to main content
Version: 8.4

Textfield

A text field allowing the user to read and edit textual data.

Form Text Field Symbol

Configurable properties

  • Field label: Label displayed on top of the text field. Can either be an expression, plain text, or templating syntax.
  • Field description: Description provided below the text field. Can either be an expression, plain text, or templating syntax.
  • Key: Binds the field to a form variable, refer to data binding docs.
  • Default value: Provides a default value for the text field in case no input data exists for the given key.
  • Read only: Makes the text field read-only, meaning the user can't change but only read its state. Can be dynamically set using an expression.
  • Disabled: Disables the text field, for use during development.
  • Hide if: Expression to hide the text field.
  • Columns: Space the field will use inside its row. Auto means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the Carbon Grid documentation.
  • Validation: Given that one of the following properties is set, the form will only submit when the respective condition is fulfilled. Otherwise, a validation error will be displayed.
    • Required: Text field must contain a value.
    • Regular expression validation: Use predefined validation patterns. Available options are: Email, Phone, and Custom.
    • Minimum length: Text field must have at least n characters. Can either be an expression or a number.
    • Maximum length: Text field must not have more than n characters. Can either be an expression or a number.
    • Regular expression pattern: Text field value must match the provided RegEx pattern.
  • Appearance: Changes the visual appearance of the text field.
info

The phone pattern adheres to the international E.164 standard, omitting spaces; for example, +491234567890.

For custom formats, use the Custom validation option.

Datatypes

Text Fields can be bound to boolean, string, and number data, but will cohere the data into a string, which will lead the data to be written back to the process as a string when the form is submitted.