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) |