Check Box

The Checkbox widget provides a standardized checkbox that allows users to make binary choices. It supports both static boolean values and dynamic expressions, making it essential for forms, surveys, and any interface requiring user selections.

The Checkbox widget is highly customizable, allowing you to control its appearance, colors, shape, and icons for both checked and unchecked states.


Checkbox Properties

Property
Description

Value

A boolean that determines whether the checkbox is checked (true) or unchecked (false). Supports expressions for dynamic logic, form validation, and conditional behavior.

Size

The size of the checkbox icon in pixels.

Active Color

The background color of the checkbox when it is checked.

Inactive Color

The background color of the checkbox when it is unchecked.

Active Border Color

The border color of the checkbox when it is checked.

Inactive Border Color

The border color of the checkbox when it is unchecked.

Border Width

The width of the checkbox's border in pixels.

Shape

The shape of the checkbox. Options are Rectangle or Circle.

Border Radius

The radius of the checkbox corners. Allows individual corner customization for rounded rectangular checkboxes.

Value Property with Expressions

The Value property is particularly powerful as it accepts both static boolean values and dynamic expressions:

  • Static Values: Set to true or false for fixed checkbox states

  • Expressions: Use dynamic logic to control checkbox state based on:

    • User input from other form fields

    • Application state variables

    • Conditional logic based on user selections

    • Form validation results

Example Use Cases:

  • Form validation: isNotEmpty(user.email) && gte(length(user.password), 8)

  • Conditional agreements: gte(user.age, 18)


Icon Properties

You can customize the icons used for the checked and unchecked states.

Property
Description

Active Icon

The icon to display when the checkbox is checked. See Icon for properties.

Inactive Icon

The icon to display when the checkbox is unchecked. See Icon for properties.


Default Properties

The Checkbox widget supports only Layout and Interactions sections of Default Properties.

Last updated