cml:checkboxes

Renders a group of checkboxes. Accepts all common attributes.

<cml:checkboxes validates="required" label="Sample checkboxes:"> 
  <cml:checkbox label="Checkbox 1" /> 
  <cml:checkbox label="Checkbox 2" /> 
  <cml:checkbox label="Checkbox 3" /> 
</cml:checkboxes>

The <cml:checkbox /> children elements accept the following attributes:

checked

If this attribute is "true", the child checkbox will be pre-checked when the page loads.

<cml:checkboxes validates="required" label="Sample checkboxes:"> 
  <cml:checkbox label="Checkbox 1" checked="true" /> 
  <cml:checkbox label="Checkbox 2" /> 
  <cml:checkbox label="Checkbox 3" /> 
</cml:checkboxes>

label

The visible label for the child checkbox. This is different than the parent <cml:checkboxes> element's label attribute, which is the label for the entire group of checkboxes.

value: The value that gets submitted if the contributor selects the corresponding child checkbox. If this isn't present, the value of the label attribute is submitted.

Checkboxes also allow you to specify how test question answers should be matched to contributor inputs. To learn more about test question matching for cml:checkboxes, please visit this article.