CheckboxGroup 复选框组
用于多个勾选框绑定到同一个数组的情景,通过是否勾选来表示这一组选项中选中的项。
TIP
CheckboxGroup 组件对应 GvCheckboxGroup,支持 v-model 双向绑定。下方示例可直接交互,点击「显示代码」查看源码。
基础用法
在 GvCheckboxGroup 元素中定义 v-model 绑定变量,单一的 GvCheckbox 中,默认绑定变量的值会是 Boolean,选中为 true。 在 GvCheckboxGroup 组件中,value 是选择框的值。 如果指定的值存在于数组中,就处于选择状态,反之亦然。
自定义属性
通过 props 属性自定义 options 的别名
半选中状态
通过 indeterminate 属性来表示半选中状态。表现为➖
API
Attributes
| 属性名 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| model-value / v-model | 绑定值 | string[] | number[] | — |
| vref | 设置checkboxGroup的ref属性 | string | — |
| label | 标签文本 | string | — |
| size | 大小 | string | default |
| disabled | 是否禁用 | boolean | false |
| min | 最小选择数量 | number | — |
| max | 最大选择数量 | number | — |
| indeterminate | 半选中状态 | boolean | false |
Events
| 事件名 | 说明 | 类型 |
|---|---|---|
| change | 当绑定值变化时触发的事件 | (value: string[] | number[]) => void |