Data privacy notice

 

When this content is loaded, usage information is transmitted to Vimeo and may be processed there.

 

             

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.

NameDescription
LayoutChanges the layout how the options are displayed.
AlignmentChanges the text alignment (left, right, up, down) of the element's text. Not available for comboboxes or lists.
AutocompleteAvailable 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.

NameBeschreibung
Min. selectionSpecifies the minimum number of options that must be selected.
Max. selectionSpecifies 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.

NameDescription
Data sourcesthe 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

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article