Checkbox 多选框

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

基础用法

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

checkbox-group元素能把多个 checkbox 管理为一组,只需要在 Group 中使用 v-model 绑定 Array 类型的变量即可。 只有一个选项时的默认值类型为 Boolean,当选中时值为true

多选框组

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

wi-checkbox 元素中定义 v-model 绑定变量,单一的 checkbox 中,默认绑定变量的值会是 Boolean,选中为 true。 在 wi-checkbox 组件中,value 是选择框的值。 如果该组件下没有被传入内容,那么 label 将会作为 checkbox 按钮的 valuevalue 也与数组中的元素值相对应。 如果指定的值存在于数组中,就处于选择状态,反之亦然。

Checkbox API

Attributes

属性名说明类型默认值
model-value / v-model选中项绑定值string / number / boolean
value选中状态的值(只有在checkbox-group或者绑定对象类型为array时有效)string / number / boolean / object
label选中状态的值,只有在绑定对象类型为 array 时有效string / number / boolean / object
disabled是否禁用booleanfalse
border是否显示边框booleantrue

Events

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

Slots

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

CheckboxGroup API

Attributes

属性名说明类型默认值
model-value / v-model绑定值object[]
disabled是否禁用booleanfalse
min可被勾选的 checkbox 的最小数量number
max可被勾选的 checkbox 的最大数量number
tag复选框组元素标签stringdiv

Events

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

Slots

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

Copyright 2025 Winning Health 版权所有