Checkbox Web Control Checkbox Web Control

Checkbox Web Control

Zack Cohen Zack Cohen

Overview

The Checkbox Web control is a visible indicator of the selection state. It can be used in a Checkbox List and will have a value bound to the selected state of the Checkbox Cell, or it can exist on its own and have a value defined by its data binding.

Airhome-Checkboxes-Simple.png

Control Properties

Within a Checkbox List

There are no properties when rendered within a checkbox list. The list and Checkbox Cell give the Checkbox the data associated with its selection.

Outside of a Checkbox List

There is only a Data Binding Property to Selected outside of a list. This property is a boolean to determine whether the checkbox should be selected or not.

Control Actions

Within a Checkbox List

The Checkbox Cell performs the actions for the checkbox in this case. There are no actions on the Checkbox.

Outside of a Checkbox List

Value Changed - gets fired when the selection state of the checkbox is changed. Please check out Action Builder to find all the available actions.

Styling and Theming

Checkboxes behave like a Button. This means that checkboxes have styles for the following states:

  • Default - When first rendered without state
  • Hover - When the user is hovering over the checkbox
  • Focused - when the checkbox or checkbox cell is focused.
  • Pressed - when the checkbox is being pressed.
  • Selected - when the data binding evaluates to true.
  • Disabled - When the cell is disabled.

Examples

Example 1: Checkboxes in List of items to make a selection

Checkboxes can be used in a Checkbox List to display the selection state on a list of items:

Airhome-Checkboxes-Simple.png

To enable this, place a checkbox within a Checkbox Cell Web Control within a Checkbox List Web Control. The Cell and List will maintain the state of the checkbox.

Example 2: Checkbox to acknowledge reading an agreement

Checkboxes are also commonly used to confirm consent.

Airhome-Checkbox-LegalAgreement.png

In this example, the Checkbox operates by itself and exists without a checkbox list. Add the checkbox, and an automatically generated variable will hold its value.

Further Reading

Add comment

Article is closed for comments.