Form field: selection

Modified on Wed, 17 Jul at 4:34 PM

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

Possible layouts of a selection element.

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.

Additional display properties for a selection element.

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.

Constraints for a selection element.

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

New properties section options for select elements.

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.