A text field is used to enter or display simple or more complex texts or numbers.

At the end of the 'Common' section in the properties window, one of the following variants for the text field can be selected for each text field via the 'Element type' property:


Single-line text/default	Single-line text field (The Enter key is ignored when entered).
Multi-line text	Multi-line text field (The Enter key inserts a line break in the text; a vertical scroll bar appears if required). ►CAUTION◄ When a text field of this type has a behaviour with the trigger event Taste gedrückt stored for the Enter key, this will also be processed when inserting the line break. Therefore, actions that move the focus away from the text field (Show alert, Set focus to element) should be avoided. Otherwise, the input of multi-line texts becomes problematic.
Auto complete	A one-line text field that suggests entries for auto completion. Which entries appear here is determined via the service configuration of the text field. See service configuration in the Combobox chapter.
Formatted text	A text editor for formatted texts. Produces HTML code that is stored as the text value of the data field. ►NOTE◄ The fact that the input in the editor is saved as HTML code must also be taken into account when defining validators, behaviour and actions. Because these process the HTML code and not the displayed plain text. Even with an action like Set value, the code is transferred and not the plain text. The HTML code does not contain any 'root node', so that e.g. the behaviour Gefüllt can distinguish as usual whether or not an input has already been made in the editor.
Syntax highlighter	A multi-highlighting editor, which supports various syntax. Such as: xml, json, java, text, etc. The syntax is selected via the text field property 'Highlighting mode'.

The following settings can be made for normal text fields:

images/download/attachments/58596130/image2020-12-3_14-45-19-version-1-modificationdate-1607003121351-api-v2.png

(1) Password: Specifies whether to obscure the display of the text field by character-by-character substitution with *: images/download/attachments/58596130/image2016-1-13_8_21_56-version-1-modificationdate-1611131234627-api-v2.png

(2) Browser form autofill: Switches on/off the automatic filling of the text field by the internal address management of the browser. See the subchapter Autofüllen von Formularfeldern durch den Browser.

(3) Max. characters: Specifies the maximum number of letters that can be entered, where 0 is interpreted as an unlimited number.

(4) Restrict: Restrictions can be made here as to which types of input should be allowed. Depending on the setting, the input value is automatically converted.

Option	Short description	Notes/Special cases
No restriction	All characters allowed	(default)
Letters only	Forbidden: Numbers and special characters	The characters a-z and A-Z are considered as letters, as well as characters with codes between 128 and 255, so that in German, the umlauts, the 'ß' but also many other characters are considered letters and not as special characters. Even more specific restrictions for the input can be mapped via one or more validators (e.g. as a regular expression (validator)).
Numbers only	Valid: Numbers, minus sign, decimal separator (DE: comma), thousands separator (DE: dot)	The thousands separator can also be used 'nonsensically' during input. It is simply ignored during conversion. The decimal separator can be used 'nonsensically'. However, the entered string will be truncated at the second occurrence. The minus sign must be used in front for negative values. In any other position it will be truncated – as well as subsequent characters.
Integer only	Valid: Numbers, minus sign	The minus sign must be used in front for negative values. In any other position it will be truncated – as well as subsequent characters.
Big integer (Long)	Valid: Numbers, minus sign... with value range from -263 to +263-1 ... The value is converted to the data type 'Long'.	see 'Integer only'
Big decimal number	Valid: Numbers, minus sign decimal separator (DE: comma), thousands separator (DE: dot)... Big decimal numbers are allowed... The value is converted to the 'Big Decimal' data type.	see 'Numbers only'

(5) Decimal places: Defines the maximum number of decimal places.

(6) Thousands seperator: Specifies whether a number is to be displayed with a thousands separator character.

(7) Step: Specifies the step size of the stepper for numerical values.

(8) Min. value: Specifies the minimum numeric value (empty means no minimum).

(9) Max. value: Specifies the maximum numeric value (empty means no maximum).

Auto-filling of form fields by the browser

The option Browser form autofill can be used to de-/activate whether the browser is allowed to fill fields using its internal address and access management. When and how the browser can match a field with an address or access depends on the implementation of the browser. Modern browsers are able to recognize the fields by their labels and then try to fill them accordingly.
As a rule, the fields must have common names such as 'Username', 'Password', 'Name', 'Street', 'Postal code', so that the auto-fill function comes into play.

Example

A form in a process should enable customers to search for order information themselves.
For this purpose, a form with three fields is created, which are labeled Name, Street and Postal code. The option Browser form autofill is activated for all three text fields..

images/download/attachments/58596130/image2020-12-3_14-54-16-version-1-modificationdate-1607003658630-api-v2.png

When running the example, it becomes clear that the browser has recognized the fields as address fields and therefore suggests filling them with a known address when entering them.

images/download/attachments/58596130/image2020-12-3_14-56-30-version-1-modificationdate-1607003792195-api-v2.png
Example: Chrome

Depending on the browser settings, the form can also be prefilled right away.