Appearance
checkbox多选框
在一组备选项中进行多选。
基本用法
单独使用可以表示两种状态之间的切换,写在标签中的内容为 checkbox 按钮后的介绍。
loading
禁用状态
多选框不可用的状态。 设置 disabled 属性即可
loading
多选框组
适用于多个勾选框绑定到同一个数组的情景,通过v-model来绑定数组,用label来指定选项框对应的value。
loading
中间状态
indeterminate 属性用以表示 checkbox 的不确定状态,一般用于实现全选的效果
loading
按钮样式
按钮样式的多选组合。
只需要把 f-checkbox 元素替换为 f-checkbox-button 元素即可。 此外,fan-ui 还提供了size属性。
loading
带有边框
设置border属性可以渲染为带有边框的多选框。
loading
Checkbox API
Checkbox Attributes
| 属性名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| v-model\modelValue | string | number | boolean | undefined | 用于双向绑定的值 |
| label | string | number | boolean | object | undefined | 选项框对应的 value |
| value | string | number | boolean | object | undefined | 输入框的值 |
| indeterminate | boolean | - | 表示 checkbox 的不确定状态 |
| disabled | boolean | - | 禁用状态 |
| checked | boolean | false | 是否选中 |
| name | string | undefined | 原生 name 属性 |
| size | large | default | small | - | 组件大小 |
Checkbox Events
| 事件名 | 参数 | 描述 |
|---|---|---|
| change | val: string | number | boolean | 当复选框状态发生变化时触发 |
CheckboxGroup API
CheckboxGroup Attributes
| 属性名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| v-model\modelValue | Exclude<CheckboxValueType, boolean>[] | [] | 用于双向绑定的数组,存储选中的值 |
| disabled | boolean | - | 禁用状态 |
| size | large | default | small | default | 组件大小 |
CheckboxGroup Events
| 事件名 | 参数 | 描述 |
|---|---|---|
| change | val: Exclude<CheckboxValueType, boolean>[] | 当复选框组状态发生变化时触发 |
CheckboxButton API
CheckboxButton Attributes
| 属性名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| v-model\modelValue | Exclude<CheckboxValueType, boolean>[] | [] | 用于双向绑定的数组,存储选中的值 |
| disabled | boolean | - | 禁用状态 |
| size | large | default | small | default | 组件大小 |
CheckboxButton Events
| 事件名 | 参数 | 描述 |
|---|---|---|
| change | val: Exclude<CheckboxValueType, boolean>[] | 当复选框组状态发生变化时触发 |
