# checkbox-group (w-checkbox-group)

- **Import**: `WCheckboxGroup` from `win-design-next`
- **Tag**: `<w-checkbox-group>`
- **说明**: WCheckboxGroup
- **分类**: data-entry
- **Skill 版本**: V1.1.0
- **适配组件库**: win-design-next 1.2.2
- **API 来源**: `docs/zh-CN/component/checkbox.md`

## API

## CheckboxGroup API

### Attributes

| 属性名                      | 说明                               | 类型                                     | 默认值  |
| --------------------------- | ---------------------------------- | ---------------------------------------- | ------- |
| model-value / v-model       | 绑定值                             | ^[object]`string[] \| number[]`          | []      |
| size                        | 多选框组尺寸                       | ^[enum]`'large' \| 'default' \| 'small'` | —       |
| disabled                    | 是否禁用                           | ^[boolean]                               | false   |
| min                         | 可被勾选的 checkbox 的最小数量     | ^[number]                                | —       |
| max                         | 可被勾选的 checkbox 的最大数量     | ^[number]                                | —       |
| aria-label ^(a11y)          | 原生 `aria-label`属性              | ^[string]                                | —       |
| text-color                  | 当按钮为活跃状态时的字体颜色       | ^[string]                                | #ffffff |
| fill                        | 当按钮为活跃状态时的边框和背景颜色 | ^[string]                                | #2d5afa |
| tag                         | 复选框组元素标签                   | ^[string]                                | div     |
| validate-event              | 是否触发表单验证                   | ^[boolean]                               | true    |
| label ^(a11y) ^(deprecated) | 原生 `aria-label`属性              | ^[string]                                | —       |

### Events

| 事件名 | 说明                     | 类型                                               |
| ------ | ------------------------ | -------------------------------------------------- |
| change | 当绑定值变化时触发的事件 | ^[Function]`(value: string[] \| number[]) => void` |

### Slots

| 插槽名  | 说明           | 子标签                     |
| ------- | -------------- | -------------------------- |
| default | 自定义默认内容 | Checkbox / Checkbox-button |
