Check 选择
同时支持单选、多选、单选组、多选组的选择框,用于替换 Radio
和 Checkbox
演示
基础使用
通过 type
可以指定选择框的类型,默认是 radio
, 可以设置为 checkbox
;v-model
绑定的是选择框的选中状态
也可以通过
checked
属性设置选中
禁用状态
通过 disabled
属性可以禁用选择框,禁用状态下不能点击选中
自定义文本
可以通过自定义 default
插槽来自定义选择框的文本
选择组
使用 lv-check-group
元素来包裹 lv-check
元素,实现复选框组。使用时需要给 lv-check
传递 value
属性。
按钮组
将 appearance
设置为 button
可以将选择框渲染为按钮组
中间状态
通过 indeterminate
属性可以将选择框设置为中间状态
API
Check Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
type | 选择框的类型 | 'radio' | 'checkbox' | 'radio' |
indeterminate | 是否为中间状态, checkbox 类型下有效 | boolean | false |
label | 选择框的文字 | string | - |
checked | 是否选中 | boolean | false |
value | 选择框的值 | string | number | - |
name | 选择框的名称 | string | - |
disabled | 是否禁用 | boolean | false |
appearance | 选择框的样式 | 'default' | 'button' | 'default' |
v-model | 选中的值 | boolean | string | number | false |
Check Events
事件名 | 说明 | 类型 |
---|---|---|
change | 选中状态改变时触发 | (checked: boolean | string | number) => void |
Check Slots
插槽名 | 说明 |
---|---|
default | 自定义选择框的文字 |
CheckGroup Events
事件名 | 说明 | 类型 |
---|---|---|
change | 选中状态改变时触发 | (checked: Array<string | number>) => void |
CheckGroup Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
v-model | 选中的值 | Array<string | number> | [] |
type | 选择框的类型 | 'radio' | 'checkbox' | 'radio' |
name | 选择框的名称 | string | - |
appearance | 选择框的样式 | 'default' | 'button' | 'default' |
gap | 选择框之间的间距 | string | - |
CSS Vars
名称 | 描述 | 默认值 |
---|---|---|
--l-check-size | 选择框的大小 | 16px |
--l-check-font-size | 选择框的文字大小 | var(--l-check-size) |