复选框
一组用于多项选择的选项。
WARNING
label 充当 value 已被弃用,label 仅用作显示文本,此操作**将在 3.0.0 中删除,考虑切换到新 API。
TIP
2.6.0中添加了新的API value,文档中的示例均使用value。 如果您使用的版本低于2.6.0并使用checkbox-group,请参考:
<template>
<el-checkbox-group v-model="checkList">
<!-- works when >=2.6.0, recommended ✔️ value not work when <2.6.0 ❌ -->
<el-checkbox label="Option 1" value="Value 1" />
<!-- works when <2.6.0, deprecated act as value when >=3.0.0 -->
<el-checkbox label="Option 2 & Value 2" />
</el-checkbox-group>
</template>基本用法
复选框可以单独使用来在两种状态之间切换。
在 el-checkbox 中定义 v-model(绑定变量)。单个checkbox默认值为Boolean,选中后变为true。 el-checkbox 标签内的内容将成为复选框按钮后面的描述。
禁用状态
复选框的禁用状态。
设置 disabled 属性。
复选框组
用于绑定为一组的多个复选框,通过检查是否选中来指示是否选中某个选项。
checkbox-group 元素可以通过使用绑定为 Array 的 v-model 来管理一组中的多个复选框。在 el-checkbox 元素内,value 是复选框的值。如果该标签中没有嵌套任何内容,则 label 将呈现为复选框按钮后面的描述。 value 也对应于数组中的元素值。如果数组中存在指定的值,则选择该值,反之亦然。
选项属性 2.11.2
el-checkbox-group 基本用法的快捷方式。您可以通过props属性自定义options的别名。
不确定
indeterminate 属性可以帮助您实现“检查全部”效果。
检查的最小/最大项目
min 和 max 属性可以帮助您限制检查项目的数量。
按钮样式
具有按钮样式的复选框。
您只需将 el-checkbox 元素更改为 el-checkbox-button 元素即可。我们还提供 size 属性。
有边框
border 属性向复选框添加边框。
复选框 API
复选框属性
| 名称 | 描述 | 类型 | 默认 | | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | ------------------------------------------------------------------------------- | --- | | 模型值 / v 模型 | 绑定值 | 字符串 / 数字 / 布尔值 | — | | 值 2.6.0 | | checkbox-group | 在 checkbox-group 中使用时复选框的值字符串 / 数字 / 布尔值 / 对象 | — | | 标签 | 在 checkbox-group 内部使用时复选框的标签。如果没有值,label 将充当 value | 字符串 / 数字 / 布尔值 / 对象 | — | | 真值 2.6.0 | 复选框的值(如果已选中) | 字符串 / 数字 | — | | 假值 2.6.0 | 复选框的值(如果未选中) | 字符串 / 数字 | — | | 已禁用 | 复选框是否被禁用 | 布尔值 | 假 | | 边框 | 是否在复选框周围添加边框 | 布尔值 | 假 | | 尺寸 | 复选框的大小 | 枚举 | — | | 名称 | 原生“名称”属性 | 字符串 | — | | 已检查 | 如果复选框被选中 | 布尔值 | 假 | | 不确定 | 设置不确定状态,只负责样式控制 | 布尔值 | 假 | | 验证事件 | 是否触发表单验证 | 布尔值 | 真实 | | 标签索引 | 输入选项卡索引 | 字符串 / 数字 | — | | 编号 | 输入ID | 字符串 | — | | aria-controls a11y 2.7.2 | 与 aria-controls 相同,当 indeterminate 为 true 时生效 | 字符串 | — | | 咏叹调标签 a11y | 原生 aria-label 属性 | 字符串 | — | | true-label ^(已弃用) | 复选框的值(如果已选中) | 字符串 / 数字 | — | | 错误标签 ^(已弃用) | 复选框的值(如果未选中) | 字符串 / 数字 | — | | 控制 a11y 已弃用 | 与 aria-controls 相同,当 indeterminate 为 true 时生效 | 字符串 | — |
复选框事件
| 名称 | 描述 | 类型 |
|---|---|---|
| 改变 | 绑定值改变时触发 | 功能 |
复选框槽
| 名称 | 描述 |
|---|---|
| 默认 | 自定义默认内容 |
复选框组 API
CheckboxGroup 属性
|名称 |描述 |类型 |默认 | | ------------------------ | | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------- | |模型值 / v 模型 |绑定值| 数组 | []| |尺寸|复选框的大小 | 枚举 | — | |已禁用 |嵌套复选框是否被禁用 | 布尔值 |假 | |分钟|选中复选框的最小数量 | 数字 | — | |最大|选中复选框的最大数量 | 数字 | — | |咏叹调标签 a11y 2.7.2 |原生 aria-label 属性 | 字符串 | — | |文本颜色 |按钮激活时的字体颜色 | 字符串 | #ffffff| |填充|按钮处于活动状态时的边框和背景颜色 | 字符串 | #409eff | |标签|复选框组的元素标签 | 字符串 |分区 | |验证事件 |是否触发表单验证 | 布尔值 |真实| |标签 a11y 已弃用 |原生 aria-label 属性 | 字符串 | — | |选项 2.11.2 |选项数据,value 和 label 和 disabled 的密钥可以通过 props 自定义 | 数组 | — | |道具 2.11.2 |配置选项| 对象 | {value: 'value', label: 'label', disabled: 'disabled'} | |输入 2.11.5 |渲染选项的组件类型(例如 'button')| 枚举 | '复选框' |
CheckboxGroup 事件
| 名称 | 描述 | 类型 |
|---|---|---|
| 改变 | 绑定值改变时触发 | 功能 |
CheckboxGroup 插槽
| 名称 | 描述 | 子标签 |
|---|---|---|
| 默认 | 自定义默认内容 | 复选框/复选框按钮 |
复选框按钮 API
复选框按钮属性
| 名称 | 描述 | 类型 | 默认 | | ---------------------- | ------------------------------------------------------------------------------ | ----------------------------------------- | ------------------------------------------------------------------------------- | --- | | 值 2.6.0 | | checkbox-group | 在 checkbox-group 中使用时复选框的值字符串 / 数字 / 布尔值 / 对象 | — | | 标签 | 在 checkbox-group 内部使用时复选框的标签。如果没有值,label 将充当 value | 字符串 / 数字 / 布尔值 / 对象 | — | | 真值 2.6.0 | 复选框的值(如果已选中) | 字符串 / 数字 | — | | 假值 2.6.0 | 复选框的值(如果未选中) | 字符串 / 数字 | — | | 已禁用 | 复选框是否被禁用 | 布尔值 | 假 | | 名称 | 原生“名称”属性 | 字符串 | — | | 已检查 | 如果复选框被选中 | 布尔值 | 假 | | true-label ^(已弃用) | 复选框的值(如果已选中) | 字符串 / 数字 | — | | 错误标签 ^(已弃用) | 复选框的值(如果未选中) | 字符串 / 数字 | — |
复选框按钮槽
| 名称 | 描述 |
|---|---|
| 默认 | 自定义默认内容 |