The icon for elements of type Selection.
Form elements of type selection add a selection with multiple options to the current form. The property panel label allows you to add a descriptive label to the form field.
A selection can be displayed in different ways:
- as a combobox
- as a drop down list
- as a list of checkboxes
- as a list of radio buttons
- as questions with checkboxes (useful for surveys)
- as questions with radio buttons (useful for surveys)
The layout can be set on the basic property panel of the formcycle Designer.
If a selection is shown as a combobox and it is not a required field, the first option is selected by default. When it it is a required field, no option will be selected initially and the text Please select is displayed.
Functionality
Properties
Overview of the standard properties
This section describes only those properties that are different from the standard.
Style
This form element possesses the following additional properties for the section Style.
Name | Description |
---|---|
Layout | Changes the layout how the options are displayed. |
Alignment | Changes the text alignment (left, right, up, down) of the element's text. Not available for comboboxes or lists. |
Autocomplete | Available only if the layout is combobox. When this option is activated, the select element is shown as a text input field. As the users is entering text, they are offered a list of possible options. |
Allow free text 7.2.0+ | Available only when Autocomplete is enabled. Allows the user to enter any value, even if no option corresponding to that value exists. |
Column width | The width of each option in pixels. Only available for the horizontal display modes checkboxes and radio buttons. |
Constraints
This form element possesses the following additional properties for the section Constraints.
Name | Beschreibung |
---|---|
Min. selection | Specifies the minimum number of options that must be selected. |
Max. selection | Specifies the maximum number of options that can be selected. Set this to 0 to allow any number of options. |
Options
Name | Description |
---|---|
Data sources | the selection "data source" connects the form element with a data source. By default, the custom opinion is selected, allows to enter the selection texts and values in a list manually. If a data source is selected, its values are displayed in the selection. Manually entered values will then only be displayed as a fallback if the data source is not reachable. CSV and DB Queries can be used as data sources. For selection elements of the type Questions (Checkboxes) and Questions (Radio Buttons), an additional list is displayed where you must enter the questions to be used. These cannot be read from data sources and must always be configured directly in the form element. |
text column | Only if a data source has been selected: selection of which column from the selected data source should be used for the user-visible selection text. |
values column | Only if a data source has been selected: selection of which column from the selected data source the value to be transmitted (technical value) should be taken from |
render all attributes | Only if a data source has been selected: This option should be activated for reading all columns of a data source that have more than text and value columns or for accessing all columns by JavaScript. Without activating this option, only the specified column titles, text and value are rendered in the browser and therefore the remaining columns cannot be accessed. The columns are added to the selection options as the attribute data-colX, the X represents the index. Please also note which data are contained in the data source you are using. |
display default options | Only for drop-down selection lists: choose whether a default option "Please select" should always be displayed. If a selection element is set as a requiered field, this option is enabled by default, but it can be individuallly disabled again. Conversely, if the selection element is configured not to be a required field, this option is automatically disabled and can then be individually re-enabled. |
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article