Skip to content

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大小stringdefault
disabled是否禁用booleanfalse
min最小选择数量number
max最大选择数量number
indeterminate半选中状态booleanfalse

Events

事件名说明类型
change当绑定值变化时触发的事件(value: string[] | number[]) => void