The <group> Tag
Purpose
The <group> tag does not render to a specific element. It is a container for two or more checkbox or radio items, which appear in its body. We use a group to extract the redundant attributes (especially the name attribute) from a set of checkbox/radio items corresponding to the same input field.
A <group> tag may expose its group model to page scope. The group model contains information about the selection state. If form data is available, it "knows" how many and which items are to be checked.
The <group> tag may take a list model in its listModel attribute. In this case, the values of contained checkbox and radio items are verified to be valid keys in that list model.
Requirements
A <group> tag has to be embedded in a <form> tag.
Attributes
Attribute groups: none.
| Name | Description |
|---|---|
| assertClass | Appended to the HTML class attribute of the contained items, if an assertion concerning this input group failed. (Default: equally named attribute value of the embedding form.) |
| assertStyle | Appended to the HTML style attribute of the contained items, if an assertion concerning this input group failed. (Default: equally named attribute value of the embedding form.) |
| errorClass | Appended to the HTML class attribute of the contained items, if the validation of this input group failed. (Default: equally named attribute value of the embedding form.) |
| errorStyle | Appended to the HTML style attribute of the contained items, if the validation of this input group failed. (Default: equally named attribute value of the embedding form.) |
| listModel | The group's list model. If given, the value attributes of contained checkbox and radio items are verified to to be valid keys of that model. |
| name | Required - Used as the name attribute for the contained items. |
| varGroupModel | If set, the tag exposes its group model to a page scope attribute of that name. The group model contains information about the selection state. |
Body
The <group> tag requires a body containing the checkbox or radio items, which are to be grouped together.