The checkbox field control enables your users to select one or more values from a predefined set of choices that are displayed as checkboxes.
When to use this field?
You may consider the following pointers to determine when to use a checkbox field:
- Opt to use a checkbox field if the data that you want to enable your users to enter spans a defined set of choices, and one or more of these choices can be present per entry (or record).
- The multi-select field also enables your users to select multiple values from the predefined set of choices. Where the checkbox and multi-select fields differ is the way the choices are displayed when your users access them on a web-browser: as checkboxes and in a drop-down menu, respectively.
- If you want to enable your users to select a single value, you must opt to add a drop-down or radio button field to your form.
- If you want to create a dynamic picklist that allows your users to select multiple values, then you must opt to use a lookup field.
A choice displayed by the checkbox field contains up to 255 characters.
Add Checkbox to the form
Firstly, find the Checkbox control in the controls add panel. Then, drag and drop it into a section or container on your form.
Basic of the Checkbox field
Open the Content > Basic block and set the Title's text of this Multiple Metadata control. For more information about Title for field control, please refer:
Set the Associated variable for this Checkbox control. When you add a new Checkbox 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 this Checkbox control to other existing variables. For more information, please refer:
Appearance of the Checkbox field
Open the Content > Appearance block to set the appearance and layout of this Checkbox control.
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: Understand the label of field controls
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. Learn how to create dynamic display rules for a control.
Choices of the Checkbox 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 Checkbox field.
- Set an initial value: Click the radio button at the beginning of each choice to set it as the initial value for a Checkbox field. The Initial value will be preselected when your users access your form. Setting an initial value does not restrict your users from removing and selecting a different set of choices from the Checkbox.
- Click the Add button to add new choices.
Validation of the Checkbox field
Open the Content > Validation block to set the properties of this checkbox control.
Readonly: Turn this ON will make this field control as view only status.
Required: Make it mandatory for your users to select at least 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. Learn more about the Custom Validation.
Action call of the Checkbox 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 Radio Button field is changed.
Style the Checkbox 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 Checkbox, and the text of option label.
- Control size: Set the size of the Checkbox.
- Field Alignment: Set the alignment of this Checkbox control as left, center or right.
- Normal / Active / Disabled: Set different styles for normal, active and disabled state of the Checkbox control. Styles below are supported to be set separately for normal, active and disabled state.
- Color: Choose the front color of the Checkbox.
- Background Color: Set background color of the Checkbox.
- 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 of title
Set the Title of field controls that are applicable to this control.
Set the Advanced options that are applicable to this control.