Edit field
The "Input field" application element is one of the basic controls. The input length is limited to 255 characters. In the image above you can see the "Title" input field, in which a title can be entered. This input can be saved with a corresponding button, provided that a data field is linked to the input field.
Input fields can be configured for different data types. A variety of control types are available.
The input field element can be found in the "Applications" module in the "Elements" area. A new input field can be created by positioning the element on the workspace from here using drag & drop.
Further information on creating elements can be found here.
The properties dialog of an input field element opens automatically when a new input field is created. The properties dialog of an existing input field can be opened by double-clicking on the element on the workspace, via the "Properties" context menu or via the "Edit / Properties" main menu if the input field is selected on the workspace.
General
The following settings can be found on the "General" tab in the properties dialog for input fields:
Title
Provide the edit field with a title. Information on multilingual titles can be found here.
Display title in control
With this setting an edit field will be made a mandatory field.
Input required
This setting makes the edit field into a mandatory field.
Write-protected
With this setting, it is no longer possible to enter data in this field.
Open numeric pad when edit field is clicked
This setting is available for input fields with the control type "Integer", "Floating point number" or "Currency" on pages that are transformed for mobile devices. This shows a numeric keypad on the mobile device that can be used to select and enter numbers into the field.
On the "Options" tab, you will find different settings for the various control types in the input field.
Options - "Text" control type
Maximum number of characters available
In this field, you can define the maximum amount of characters that may be entered. If no value is entered, a maximum of 255 characters are permitted. If the number of characters is exceeded, a message is displayed during input.
Regular expression to restrict the characters
You can enter a regular expression that defines which characters may be entered. Other characters will not be accepted. The following regular expressions are possible:
-
[a-z]
exactly one lower case letter from a-z
-
[a-z]*
0 to infinite letter from a-z
-
[0-9]
exactly one number between 0 and 9
-
[a-zA-Z0-9_]
exactly one character of the set: letters (upper and lower case), digits and the underscore
-
[abc]
a,b or c
-
[^abc]
not a,b or c
Characters that must be escaped with backslash:
(){}[]\|/+?*.^&-<>^=$!
Options - "E-mail" control type
Maximum number of characters available
In this field, you can define the maximum amount of characters that may be entered. If no value is entered, a maximum of 255 characters are permitted. If the number of characters is exceeded, a message is displayed during input.
Email address validation
This setting will check whether the email address contains an @ character and a domain.
Options - "URL" and "Telephone" control type
Maximum number of characters available
In this field, you can define the maximum amount of characters that may be entered. If no value is entered, a maximum of 255 characters are permitted. If the number of characters is exceeded, a message is displayed during input.
Control type "Color"
There are no optional settings for input elements with the "Color" control type. Clicking in the input field opens a palette in the browser from which the desired color can be selected.
Options - "Integer" control type
Minimum value / maximum value
Here you define the value that must not be undercut or exceeded during input. The value will be checked before the page is saved. If values are not permitted, a corresponding message is displayed.
Thousands separator
This can be displayed as a point or a comma. If you select the "Portal setting" entry, the separator is output according to the setting of the number format in the country settings of the portal for the respective language.
Options - "Floating point number" and "Currency" control types
Minimum value / maximum value
Here you define the value that must not be undercut or exceeded during input. The value will be checked before the page is saved. If values are not permitted, a corresponding message is displayed.
Separator character
Use company settings
With this setting, the separator is used according to the setting of the number format in the country settings of the portal for the respective language. If you want to set the 1000 separator and decimal separator differently from the portal settings, deactivate this setting so that the "1000 separator" and "Decimal separator" settings are activated.
Thousands separator
Select the desired separator.
Decimal separator
Select the desired decimal separator.
Decimal place
Use company settings
With this setting, the decimal point is used according to the setting of the number format in the country settings of the portal for the respective language. If you want to set the decimal place differently from the portal settings, deactivate this setting so that the settings "Leading zero" and "Decimal places" are activated.
Leading zero
Defines the format for the display of zeroes in front of the number (i.e. 0.7 or .7).
Decimal places
Enter an integer that defines how many decimal places should be displayed.
Options - "Date", "Time", "Date & time" control types
Minimum value / maximum value
Here you define the value that must not be undercut or exceeded during input. The value will be checked before the page is saved. If values are not permitted, a corresponding message is displayed.
Date format
The format for the displayed date is defined here. Here,
-
dd
is the two-digit display of the day
-
MM
is the two-digit display of the month
-
yyyy
is the four-digit display of the year
If you select "Portal setting", the format from the country settings of the portal is used for the respective language.
Time format
The format for the displayed time is defined here. Here,
-
HH
is the two-digit display of the hours
-
mm
is the two-digit display of the minutes
-
ss
is the two-digit display of the seconds
If you select "Portal setting", the format from the country settings of the portal is used for the respective language.
Calendar settings
All information about these settings can be found here.
Binding
The display values of the element can be defined on this tab in the properties dialog. All information about these settings can be found here.