# Checkbox 复选框

## 何时使用
* 在一组可选项中进行多项选择时；
* 单独使用可以表示两种状态之间的切换，和`switch`类似。区别在于切换`switch`会直接触发状态改变，而`checkbox`一般用于状态标记，需要和提交操作配合。

### 基本使用
简单的 checkbox。

@[demo](./demo/basic.vue)


### 半选状态
使用`indeterminate`来设置是否为半选中状态

@[demo](./demo/indeterminate.vue)


### 禁用状态
使用`disabled`来设置是否为禁用状态

@[demo](./demo/disabled.vue)


### 自定义值
使用`false-value`, `true-value`来设置选中及未选中的值。

当后端使用 `"1"`, `"0"` 时非常有用，不再需要去转换。

@[demo](./demo/custom.vue)



## Checkbox props

| 参数 | 说明 | 类型 | 默认值 | 可选值 |
| --- | --- | --- | --- | --- |
| v-model(checked) | 值 | String/Number/Array | false |
| label | label内容 | String | "" | - |
| name | 是否选中 | Boolean | false | - |
| readonly | 是否只读 | Boolean | false | - |
| disabled | 是否禁用 | Boolean | false | - |
| indeterminate | 是否半选中 | Boolean | false | - |
| true-value | 真值 | String/Number | true | - |
| false-value | 假值 | String/Number | false | - |
| value | 仅checkboxGroup有效 | String/Number | "" |  |
| on-change | 选择后触发的回调  | function(event, value) | function | — |

## Checkbox Group props

| 参数 | 说明 | 类型 | 默认值 | 可选值 |
| --- | --- | --- | --- | --- |
| disabled | 是否禁用 | Boolean | false | - |
| options | 指定可选项	 | array<{label,value}> | [] | - |
| type | checkbox的类型 | String | "checkbox" | "button" |


## Checkbox slots
| 插槽名 | 说明 |
| --- | --- |
| default | 代替label prop |


## events

| 事件名 | 说明 | 回调参数 |
| --- | --- | --- |
| change  | 选择后触发的回调  | function(event,value) |

### slots
| name | 说明 | slot-scope |
| --- | --- | --- |
| default | 自定义label | - |