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