Checkbox 复选框

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

TIP

Checkbox 组件对应 GvCheckbox，支持 v-model 双向绑定。下方示例可直接交互，点击「显示代码」查看源码。

基础用法

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

禁用状态​

多选框不可用状态。

设置 disabled 属性即可。

边框样式

设置 border 属性即可得到一个有边框的复选框。

大小

设置 size 属性即可得到一个不同大小的复选框。

API

Attributes

属性名	说明	类型	默认值
model-value / v-model	绑定值	string / number / boolean	—
vref	设置checkbox的ref属性	string	—
value	复选框值	string	—
visible	是否可见	boolean	true
indeterminate	设置是否全部选中状态	boolean	false
label	标签文本	string	—
disabled	是否禁用	boolean	false
border	是否显示边框	boolean	false
size	大小	string	default

Events

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

类型定义

// Checkbox 尺寸
type CheckboxSize = 'large' | 'default' | 'small';