Checkbox List

A Check box list renders a list of options and allows user to select multiple values. Use the ForEach action to loop through either all or selected values and action them one at a time.

---

Add a Checkbox List {% endembed %}

---

Properties

1. Direction

   TopToBottom or LeftToRight - How the options should display to the user

2. Options

   

   Specify a list of options to display in the control. It can be generated from a static list or from data. When populating the Options from a Connector or file, use the Field Mapping Editor found in the Property Grid (seen circled in red below) to assign the Text and the Value of the items.

3. Read-Only

   Set to True if you want the control to display as read-only (value can’t be changed) on the page.

4. Selected Value

   A comma separated list of values that should be checked on initial load.

5. Validations

   Some validations that can be applied to the List

6. Visible

   Set to False if you don’t want this control to render on the page and be visible to the user.

---

Assigning data to a Checkbox List

Example:

To display a Checkbox List of checkboxes for values retrieved by a SQL query:

1. Use an appropriate Event, e.g. Load (page) or Click (button) to which a SetValue action can be added.
2. Add a SetValue action that populates the Checkbox List (options) for each returned value.

Data:

Checkbox Lists expect a List of objects containing a text and a value property

[
    {"text":"Monday","value":"1"},
    {"text":"Tuesday","value":"2"},
    {"text":"Wednesday","value":"3"},
    {"text":"Thursday","value":"4"},
    {"text":"Friday","value":"5"}
]

The Field Mapping option in the SetValue action allows for the mapping of object properties other than text & value to these properties