Skip to content

复选框 Checkbox

基本的复选框

可以自定义是否禁用复选框、自定义图标、添加边框

复选框组

利用 v3-button-group 来管理一组复选框,可以绑定 numberstringboolean 类型的值

按钮形式的复选框

indeterminate 状态

限制最大/最小选择数量

不同尺寸的复选框

API

Checkbox Props

参数名说明类型可选值默认值
border是否带有边框booleanfalse
disabled禁用状态booleanfalse
label复选框的值string / boolean / number
indeterminate是否为不确定状态booleanfalse
selectedIcon选中时的图标stringCheckCorrect
indeterminatedIcon不确定时的图标stringReduce
defaultIcon未选中状态下的图标stringSquare
size复选框的尺寸stringsmall / medium / largemedium
modelValue单独使用时绑定的 v-modelbooleanfalse

Checkbox Events

事件名说明回调参数
change值发生变化时触发(newValue, e: Event)

Checkbox Slots

插槽名说明子标签
default默认插槽

CheckboxGroup Props

参数名说明类型可选值默认值
modelValuev-modelArray<string / boolean / number>[]
min限制的最小选择个数number / undefinedundefined
max限制的最大选择个数number / undefinedundefined

CheckboxGroup Events

事件名说明回调参数
change值发生变化时触发(newValue, e: Event)

CheckboxGroup Slots

插槽名说明子标签
default默认插槽Checkbox / CheckboxButton

CheckboxButton Props

参数名说明类型可选值默认值
disabled是否禁用booleanfalse
label绑定的值number / string / boolean''
size复选按钮的尺寸stringsmall / medium / largemedium

CheckboxButton Events

事件名说明回调参数
change值发生变化时触发(newValue, e: Event)

CheckboxButton Slots

插槽名说明子标签
default默认插槽