The Single select control allows users to select one option from a pre-defined list, making it a valuable addition to any form that requires users to make a choice from a set of options.
When to use this field?
You may consider the following pointers to determine when to use a Single select field:
Opt to use a Single select field if the data that you want to enable your users to enter spans a defined set of choices, and only one of these choices can be present per entry (or record).
The display control can be choose as Radio button, or Dropdown list. Where the radio and drop down differ is the way the choices are displayed when your users access them on a web-browser: as radio buttons and in a dropdown menu, respectively.
If you want to enable your users to select multiple values, you must opt to add a Multiple select field to your form.
If you want to create a dynamic picklist, i.e., if you want to provide an initial set of choices to select from, but want to accommodate the growth of this set, then you must opt to use a lookup field control.
Character limits
A choice displayed by the Single select field contain up to 255 characters. In other words, theSingle select field can store an input that has up to 255 characters.
Add Single select to the form
Firstly, find the Single select control in the controls add panel. Then, drag and drop it into a section or container on your form.
Basic of the Single select field
Open the Content > Basic block and set the Title's text of this Single select control. For more information about Title for field control, please refer:
Set the Associated variable for this Single select control. When you add a newSingle select control, a default variable will be generated automatically. You can click the Edit Button to change the ID and name, or click the Reset button to bind thisSingle select control to other existing variables. For more information, please refer:
Appearance of the Single select field
Open the Content > Appearance block to set the appearance and layout of this Single select control.
Display Style: One of the primary customizable features of the "Single Select" control is the "Display Style." Users can choose between two styles for presenting the options - "Dropdown List" or "Radio Button".
Dropdown: This style is suitable when the list of options is long. It saves space on the form and only reveals the options when the user clicks on the dropdown.
When the Dropdown is selected, the Placeholder setting shows toset the text of the placeholder for this Dropdown.
Radio Button: This style is perfect for shorter lists. It allows all options to be visible at a glance and provides a quicker selection process.
When the display style is set as "Radio Button", there's one additional option called "Layout" you can select,
Layout: Set the layout of the choices to be displayed horizontal or vertical.
Display Title: Choose display or hide the label of this control. For more information, please refer:
Allow comment: Turn on this option will allow users to add comments on this control.
Dynamic Display Rules: When you set a dynamic display rules, It behaves differently based on specific conditions and rules.
Choices of the Single select field
Open the Content > Choices block to add choices, edit a choice, and delete a choice.
Define the order in which the choices are displayed: You can drag a choice to arrange the choices manually in the required order.
Rename the values provided as choices in your Single select field.
Set an initial value: Click the radio button at the beginning of each choice to set it as the initial value for aSingle select field. The Initial value will be preselected when your users access your form. Setting an initial value does not restrict your users from removing it or selecting a different choice from theSingle select.
Click the clear default button to remove the initial value.
Validation of the Single select field
Open the Content > Validation block to set the properties of thisSingle select control.
Readonly: Turn this ON will make this field control as view only status.
Required: Make it mandatory for your users to select a choice.
Custom Validation: Set the custom validation rules. An error message that will display under your field when specified conditions become true. It will allow you to add any number of rules for validating your field.
Action call of the Single select field
Open the Content > Action block to call a pre-defined action from the dropdown list. This action will be triggered once the value of this Single select field is changed.
Style the Radio button control
Set the styles when the display style is set to Radio button.
Field
Open the Style > Field block to set the styles of the field control.
Gap between control and option label: Set the spacing between the Radio button, and the text of option label.
Control size: Set the size of the Radio button.
Field Alignment: Set the alignment of this Radio Button control as left, center or right.
Normal / Active / Disabled: Setdifferent styles for normal, active and disabled state of the Radio button control. Styles below are supported to be set separately for normal, active and disabled state.
Color: Choose the front color of the Radio button.
Background Color: Set background color of the Radio button.
Border Type: Select the type of border, choosing from none, solid, double, dotted, dashed, or grooved.
Radius: Set the border radius to control corner roundness.
Option Label: Set the style of the option label after the radio button control:
Typography: Set the typography options for the text of the option label.
Color: Choose the text color of the option label.
Background Color: Set background color of the option label.
Style the Dropdown control
Set the styles when the display style is set to Dropdown.
Field
Open the Style > Field - Editable block to set the styles of the field control for it's editable status.
Typography: Set the typography options for the text in the field.
Normal / Focus: Set different styles for normal state and focus state of the dropdown list. Styles below are supported to be set separately for Normal and Focus state.
Color: Choose the color of the dropdown list items text.
Background Color: Set background color of the dropdown list. By default, the background color is set as transparent.
Border Type: Select the type of border, choosing from none, solid, double, dotted, dashed, or grooved.
Radius: Set the border radius to control corner roundness.
Shadow: Adjust box shadow options
Placeholder Color: Choose the color of the placeholder text.
Align: Set the alignment of text inside the field control. Can be Left, Center or Right.
Padding: Set the Padding of the field control.
Field Width: Set the width of the field control in PX , %, em, rem, vw, calc.
Field Alignment: Set the alignment of the field control. This will only be effected when the field width is less than the outside container.
Error Message: Set the styles of the error message,
Typography: Set the typography options for the error message.
Color: Choose the color of the error message's text.
Dropdown
Open the Style > Dropdown block to set the style of the dropdown list items (choices).
Typography: Set the typography options for the text of dropdown list items.
Align: Set the alignment of text inside each of the dropdown list items. Can be Left, Center or Right.
Padding: Set the Padding of the dropdown list items.
Normal / Hover / Active: Set different styles for normal state hover and active state of each dropdown list items. Styles below are supported to be set separately for normal, hover and active state.
Text Color: Choose the color of the list items' text.
Background Color: Set background color of the drop down list.
Border Type: Select the type of border, choosing from none, solid, double, dotted, dashed, or grooved.
Radius: Set the border radius to control corner roundness.
Shadow: Adjust box shadow options
Field - Read Only
Open the Style > Field - Read Only block to set the styles of the field control for it's view only status.
Typography: Set the typography options for the text in the dropdown field.
Color: Choose the color of the field's text.
Background Color: Set background color of the field. By default, the background color is set as transparent.
Align: Set the alignment of text inside the field control. Can be Left, Center or Right.
Padding: Set the Padding of the field control.
Border Type: Select the type of border, choosing from none, solid, double, dotted, dashed, or grooved.
Radius: Set the border radius to control corner roundness.
Style of title
Style the Title of field controls that are applicable to this control.
Advanced Settings
Set the Advanced options that are applicable to this control.