Checkbox

This type of form field can be used to gather information such as interests, preferences, or approvals, and it provides a simple and intuitive way for users to interact with a form.

Configuring the Checkbox element

Checkbox generic settings

The available configuration options for this form element are:

Process data key
Properties
Datasource
Validators
Expressions
UI actions
Checkbox styling

Process data key

Process data key establishes the binding between the checkbox element and process data, enabling its later use in decisions, business rules or integrations.

Properties

Label: The visible label for the checkbox.
Helpertext: Additional information about the checkbox element, which can be optionally hidden within an infopoint.

Datasource configuration

Default value: The default value of the checkbox.
Source Type: The source can be Static, Enumeration, or Process Data.
Add option : Define label and value pairs here.

Validators

The following validators can be added to a checkbox: required and custom (more details here).

Hide/disable expressions

The checkbox behavior can be defined using JavaScript expressions for hiding or disabling the element. The following properties can be configured for expressions:

Hide condition: A JavaScript expression that hides the checkbox element when it evaluates to the specified result.
Disabled condition: A JavaScript expression that disables the checkbox when it returns a truthy value.

These expressions can be used with any form element. See the following example for details:

Input hide/disabled example

It’s important to make sure that disabled fields have the same expression configured under the path expressions → hide.

UI actions

UI actions can be added to the checkbox element to define its behavior and interactions.

Event: Possible value - CHANGE.
Action Type: Select the type of the action to be performed.

For more details on how to configure a UI action, click here.

Checkbox settings overrides

There are instances where you may need to tailor settings configured in the Generic settings tab. This proves especially beneficial when you wish to adjust these settings to appear differently across various platforms such as Web, Android, or iOS. Available override settings:

Properties:
- Label: Override the checkbox label.
- Helper: Override helper text/info point.
Expressions:
- Hide: Override the hide expression.

Overrides can always be imported/pushed from one platform to another:

Checkbox styling

Type: Set the type of the checkbox. Possible values:
- bordered
- clear

Checkbox style overrides options

Theme overrides refer to the ability to modify or customize the appearance and behavior of UI components by overriding default theme settings. This can be applied at various levels, such as specific elements or entire sections, and can be platform-specific (Web, iOS, Android).