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 |
类型定义
typescript
// Checkbox 尺寸
type CheckboxSize = 'large' | 'default' | 'small';