Checkbox 多选框

WARNING

label 作为 value 来使用已经被废弃, 建议label 只用来表示展示的文字，这个被废弃的用法将会在 3.0.0 版本被移除，请考虑使用新 API 替换.

新 API value 在2.6.0 中已经可用，您可以使用 value API 来设置复选框的值。

在一组备选项中进行多选。

基础用法

单独使用可以表示两种状态之间的切换，写在标签中的内容为 checkbox 按钮后的介绍。

多选框不可用状态。

适用于多个勾选框绑定到同一个数组的情景，通过是否勾选来表示这一组选项中选中的项。

indeterminate 属性用以表示 checkbox 的不确定状态，一般用于实现全选的效果

使用 min 和 max 属性能够限制可以被勾选的项目的数量。

按钮样式的多选组合。

属性名	说明	类型	默认值
model-value / v-model	选中项绑定值	`string` / `number` / `boolean`	—
value 2.6.0	选中状态的值（只有在`checkbox-group`或者绑定对象类型为`array`时有效）	`string` / `number` / `boolean` / `object`	—
label	选中状态的值，只有在绑定对象类型为 `array` 时有效。如果没有 value， `label`则作为`value`使用	`string` / `number` / `boolean` / `object`	—
true-value 2.6.0	选中时的值	`string` / `number`	—
false-value 2.6.0	没有选中时的值	`string` / `number`	—
true-label deprecated	选中时的值	`string` / `number`	—
false-label deprecated	没有选中时的值	`string` / `number`	—
disabled	是否禁用	`boolean`	false
border	是否显示边框	`boolean`	false
size	Checkbox 的尺寸	`enum`	—
name	原生 name 属性	`string`	—
checked	当前是否勾选	`boolean`	false
indeterminate	设置不确定状态，仅负责样式控制	`boolean`	false
validate-event	输入时是否触发表单的校验	`boolean`	true
tabindex	输入框的 tabindex	`string` / `number`	—
id	input id	`string`	—
controls a11y deprecated	与 aria-control一致, 当 `indeterminate`为 `true`时生效	`string`	—
aria-controls a11y 2.7.2	和 aria-control一致。当 `indeterminate` 为 `true` 时生效	`string`	—

事件名	说明	类型
change	当绑定值变化时触发的事件	`Function`

插槽名	说明
default	自定义默认内容

事件名	说明	类型
change	当绑定值变化时触发的事件	`Function`

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

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