<ss:forms:checkboxgroup> </...>

This control is intended to simplify the grouping of checkbox values.
Wrapping checkboxes in a group allows you to omit the name and validation attributes on individual checkboxes by applying them via name and validations attributes on the group.

Attributes

align

string

Align

Sets the alignment of checkboxes in the group.

Possible values: [Default] vertical, horizontal

string

Give this control a unique id. Can be accessed in the client DOM (eg, document.getElementById('myid') or in the server DOM using [? $myid ?] or [? $('myid') ?]).

name

string

Name

Sets the name value which will be applied to all child Checkboxes. For
Checkboxes, the name attribute indicates which form field they will submit their value to.

Note: Uses the same [ ] syntax as ss:forms:checkbox

Eg: name="fruits[]"

validations

string

Validations

Sets the validations to be applied to child checkboxes as a comma separated string.

Eg: validations="mandatory"

Examples

Grouping Checkboxes

The name of the checkbox group acts as the field to which the checkboxes will map. This is used instead of applying a name attribute to each individual checkbox.

HTML:

Populate From Datasource

CheckBoxes can be repeated from a datasource using a repeater. Take care to ensure that any generated valuechecked attributes will be unique.

HTML: