The Checkbox group is a multi select control which presents the allowable choices as check boxes.
Like almost all SPARK controls, you can trigger events that are fired when the user interacts with the control (see the Event and Methods sections below and the Event Handling article for more information).
This control is commonly used to create a list of items that allows selecting more than one item at a time.
Item Lookup Mode Method by which to populate selection list; Start Empty, Items From Service, Items From Static List, Items From Config Option
List Items Service Service to populate item selection
Service Input Data Data to be passed to the AJAX service that populates the select list items
Items List Bound list of items to populate selection
Data Mapping Set which property to take as the selection value, and which to display in the selection
Static List Static list of items to populate selection
Size Default, Large, Small
Width Width in px, %, em; for example: 50px, 20%, 0.4em, if no unit is specified, px is assumed
Label Placement Top Left
These are the configuration option settings...
This is the result...
When either using a Static List to populate the control, or if leaving the Data Mapping blank, the Checkbox Group by default uses the value property as the display value.
For example, if using the following configuration options...
This will be the result...
With the Checkbox Group control, there are 4 types of event handlers:
- On Load When the page loads
- On Service Items When there is an item service return
- On Service Error When there is a service error
- On Change When there is a change
For detailed information on the available methods for this control, access the JS Doc file.
- Author: Courtney Silva
- Date Created: June 24, 2015
- Date Modified: July 27, 2015