# checkbox-button (w-checkbox-button)

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

## API

## CheckboxButton API

### Attributes

| 名称                      | 详情                                                                                          | 类型                                           | 默认值 |
| ------------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------ |
| value                     | 选中状态的值，只有在绑定对象类型为 `array` 时有效。                                           | ^[string] / ^[number] / ^[boolean] / ^[object] | —      |
| label                     | 选中状态的值，只有在绑定对象类型为 `array` 时有效。 如果没有 value， `label`则作为`value`使用 | ^[string] / ^[number] / ^[boolean] / ^[object] | —      |
| true-value                | 选中时的值                                                                                    | ^[string] / ^[number]                          | —      |
| false-value               | 没有选中时的值                                                                                | ^[string] / ^[number]                          | —      |
| disabled                  | 是否禁用                                                                                      | ^[boolean]                                     | false  |
| name                      | 原生 name 属性                                                                                | ^[string]                                      | —      |
| checked                   | 当前是否勾选                                                                                  | ^[boolean]                                     | false  |
| true-label ^(deprecated)  | 选中时的值                                                                                    | ^[string] / ^[number]                          | —      |
| false-label ^(deprecated) | 没有选中时的值                                                                                | ^[string] / ^[number]                          | —      |

### Slots

| 插槽名  | 描述           |
| ------- | -------------- |
| default | 自定义默认内容 |
