2.7 KiB
Checkbox 复选框
用于配置不同场景的选项，提供用户可在一组选项中进行多选。
基本用法
复选框组
通过 checkbox-group 元素把多个 checkbox 元素管理为一组，在 checkbox-group 中使用 v-model 绑定 Array 类型的变量即可实现双向绑定。 checkbox 的 label 属性是其对应的值，若该标签中无内容，则该属性也充当 checkbox 后的介绍。label 与数组中的元素值相对应，如果存在指定的值则为选中状态，否则为不选中。
配置式复选框组
提供 options 属性，支持通过配置对象数组数据的形式来渲染多选框组。使用该属性后，可以不用再在标签中以插槽的形式插入 checkbox 或 checkbox-button 元素。
options 对象数组中包括三个字段：label、text、events。
另外还提供 type 属性，配合 options 属性一起使用，默认值为 checkbox。还可以配置为 button，配置后复选框组将以按钮的形式展示。
全选与半选
在 checkbox 元素中配置 indeterminate 属性为 true 后，勾选框将展示为半选的样式。
可选数量限制
在 checkbox-group 上可通过 min、max 属性指定可勾选项目的最小、最大值。
当前是否勾选
在 checked 当前是否勾选，通过 disabled 设置组件是否禁用。
垂直布局
在 checkbox-group 元素上设置 vertical 为 true，则其管理的 checkbox-button 或 checkbox 将展示为垂直布局。
内容超出时的提示信息
若复选框后的介绍文字超出时，可以通过 Tooltip 组件增加提示信息，鼠标悬停时可提示所有内容。
在 checkbox 元素上配置 border 属性为 true，可显示边框。
插槽
Checkbox 的内容