Checkbox Group
premiumMultiple checkbox options with min/max selection validation.
Overview
The Checkbox Group lets users select multiple options from a list. Validates selection count with configurable minimum and maximum, and supports the same custom icon and container styling as the single Checkbox.
Properties
| Property | Type | Default | Description |
|---|---|---|---|
name | String | "interests" | Field name used in form data. Stores an array of selected values. |
label | String | "Interests" | Label displayed above the group. |
options | Array | -- | List of options with label, value, prefix, and suffix. |
required | Boolean | false | Whether at least one option must be selected. |
minSelected | Number | -- | Minimum number of selections required. |
maxSelected | Number | -- | Maximum number of selections allowed. |
Features
- Multi-select with array value storage
- Min/max selection count validation
- Error messages support {min} and {max} placeholders
- Same icon and container styling as single Checkbox
- Option prefix and suffix text
Tips
Use minSelected and maxSelected together to enforce a range (e.g., "Select 2-5 interests").
The {min} and {max} placeholders in error messages are replaced with actual values.
Validation
This component uses checkboxGroup validation. See the Validation Guide for details on configuring rules and error messages.