Guided Workflow Screen Components - Checkbox

Updated 

Overview

A checkbox is an interactive element in a form that enables users to independently select or deselect options. Each checkbox serves as a binary control, representing a choice between two mutually exclusive options, such as "Yes" (checked) or "No" (unchecked).

Fields of the Checkbox

  1. Enable Reporting

    • This feature allows the checkbox to be utilized for reporting purposes. For example, you can track how many users select "Yes" or "No," providing insights into user preferences and actions.

  2. Configure Error Messages

    • This field enables you to define a warning message for users who fail to select the checkbox. It ensures that users are aware of mandatory selections or missed actions.

  3. Enable Custom Validation: Enables you to configure to configure custom validation logic for the Text Input component. Once enabled, additional fields appear to define the validation condition and the error message displayed when validation fails.

    • Validation Logic: Specify the condition that determines whether the entered value is valid. If it evaluates to false, validation fails and the configured error message is shown.

    • Error Message: Enter the error message to display when the validation condition evaluates to false. This field supports dynamic messaging, enabling you to surface backend-specific validation responses such as duplicate values or invalid credentials.

    • Run Validation on Screen Load: Enable this to evaluate the validation condition when the screen loads, instead of waiting for the user to submit the screen. When this option is enabled,

      • The validation condition is evaluated before the screen loads.

      • The corresponding Text Input fields display error states immediately

      • Users do not need to click *Next* or Submit to view validation errors

  4. Visibility Conditions

    • The checkbox content will be displayed based on visibility conditions. For example, if a variable is defined before the screen and the checkbox's appearance depends on that variable, visibility conditions can be utilized to control its display.

By offering flexibility and interactivity, checkboxes enhance user engagement and facilitate conditional workflows within forms.