Skip to main content

Single line text field

The single-line control element is the “classic” text field in a digital form and one of the most frequently used control elements with a very wide range of applications. For example, you can use it to query an address, an e-mail, an amount of money or a project number.

Configuration​

The following options are available within the configuration

  • Title:
    Enter the display name of the control element here. This is displayed to the users so that they know which control it is.
  • Internal name:
    The internal name allows you to reference a control in placeholders or rules using a name other than the title. This field does not have to be filled in, but is helpful if you have several controls with the same title in a form.
  • Mandatory field:
    If you activate this option, people must fill in this field before the form can be transferred to the next process step via a button. In this way, you can force a form to have all the necessary information before it is sent.
    Caching is possible at any time, even if mandatory fields are not filled in.
  • Read-only:
    If you mark a field as read-only, the field cannot be filled in by persons. This is particularly useful in combination with a default value in order to display certain values but not be able to change them. For example, you can display which person is currently logged in and accordingly record which person has sent a form.
  • Exclude from PDF export:
    The standard PDF export exports all control elements in the form. If you activate this option, the element is not included in the standard PDF export.
    The control element can still be used manually in a document template.
  • Default value:
    Here you can define the default value of the text field. In particular, you can use placeholders to display dynamic values, e.g. a value from a previous form.
  • Format:
    The format defines the format in which the values must be entered. This also defines the form in which the value is validated. The following formats are available:
    • Free text:
      This format does not restrict the data that is entered and any text values can be entered.
    • Number field:
      In this format, people can only enter numbers. This can be helpful, for example, to request a sum of money or similar.
    • E-mail:
      This format forces the entry of a valid e-mail address.
    • IBAN:
      If you select this format, a valid IBAN is forced to be entered. Checksums are also validated.
    • Custom format:
      This option allows you to define your own format, with a field displayed under the format to define the mask. The mask describes the format in which individuals must input values, utilising special characters such as 9 for numbers 0-9, a for letters (upper or lower case from a to z), and * for letters or digits. Only these special characters can be filled in by users, while all other characters are fixed in the mask and cannot be changed. For instance, in the format +(99) 9999 999 999, users can input a phone number where the + symbol and brackets are fixed and fields with 9 can be replaced with numbers. Also, to display 9, a, or * as a fixed value, one must use a backslash () to mask the character, for example, \9 displays a 9.
  • Help text:
    If you enter a value here, a help icon () is displayed next to the control. People can click on this to display the help text. This allows you to give people help on an individual control.

Placeholder​

This control provides a placeholder that you can use to reference the entered value. The formatting adapts depending on the format:

  • Free text and Custom format:
    Here, the value is adopted as it is.
  • Number field:
    For a number field, you can transfer the value as a number with decimal point values, as well as an integer without decimal point values. This placeholder can also be used in places where only numbers are permitted.
  • Email:
    The value is adopted here as it is. However, you can also use this formatting to reference the text field as a recipient in an e-mail action.
  • IBAN:
    With this format, the value is formatted so that the IBAN is displayed with spaces to increase readability.