## Checkbox 多选框 一组备选项中进行多选 ### 基础用法 单独使用可以表示两种状态之间的切换 :::demo 在`el-checkbox`元素中定义`v-model`绑定变量，单一的`checkbox`中，默认绑定变量的值会是`Boolean`，选中为`true`。 ```html ``` ::: ## 禁用状态 多选框不可用状态。 ::: demo 设置`disabled`属性即可。 ```html ``` ::: ### 多选框组 适用于多个勾选框绑定到同一个数组的情景，通过是否勾选来表示这一组选项中选中的项。 :::demo `checkbox-group`元素能把多个 checkbox 管理为一组，只需要在 Group 中使用`v-model`绑定`Array`类型的变量即可，`label`属性除了改变 checkbox 按钮后的介绍外，同时也是该 checkbox 对应的值，`label`与数组中的元素值相对应，如果存在指定的值则为选中状态，否则为不选中。 ```html ``` ::: ### 可切换值的多选框 多选框单独时，除了可以表示为是否选中的逻辑值以外，你还可以设定其选中和未选中所表示的值。 :::demo 使用`true-label`和`false-label`可以自定义选中时和未选中时的值，可以为`String`或`Number`类型。 ```html ``` ::: ### Checkbox Attributes | 参数 | 说明 | 类型 | 可选值 | 默认值 | |---------- |-------- |---------- |------------- |-------- | | label | 选中状态的值（只有在`checkbox-group`下有意义） | string | — | — | | true-label | 选中时的值 | string, number | — | — | | false-label | 没有选中时的值 | string, number | — | — | | disabled | 按钮禁用 | boolean | — | false | | checked | 当前是否勾选 | boolean | — | false | | indeterminate | 设置 indeterminate 状态，只负责样式控制 | boolean | — | false | ### Checkbox-group Events | 事件名称 | 说明 | 回调参数 | |---------- |-------- |---------- | | change | 当绑定值变化时触发的事件 | event 事件对象 |