Skip to content

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\modelValuestring | number | booleanundefined用于双向绑定的值
labelstring | number | boolean | objectundefined选项框对应的 value
valuestring | number | boolean | objectundefined输入框的值
indeterminateboolean-表示 checkbox 的不确定状态
disabledboolean-禁用状态
checkedbooleanfalse是否选中
namestringundefined原生 name 属性
sizelarge | default | small-组件大小

Checkbox Events

事件名参数描述
changeval: string | number | boolean当复选框状态发生变化时触发

CheckboxGroup API

CheckboxGroup Attributes

属性名类型默认值描述
v-model\modelValueExclude<CheckboxValueType, boolean>[][]用于双向绑定的数组,存储选中的值
disabledboolean-禁用状态
sizelarge | default | smalldefault组件大小

CheckboxGroup Events

事件名参数描述
changeval: Exclude<CheckboxValueType, boolean>[]当复选框组状态发生变化时触发

CheckboxButton API

CheckboxButton Attributes

属性名类型默认值描述
v-model\modelValueExclude<CheckboxValueType, boolean>[][]用于双向绑定的数组,存储选中的值
disabledboolean-禁用状态
sizelarge | default | smalldefault组件大小

CheckboxButton Events

事件名参数描述
changeval: Exclude<CheckboxValueType, boolean>[]当复选框组状态发生变化时触发