复选框

一组用于多项选择的选项。

WARNING

label 充当 value 已被弃用label 仅用作显示文本,此操作**将在 3.0.0 中删除,考虑切换到新 API。

TIP

2.6.0中添加了新的API value,文档中的示例均使用value。 如果您使用的版本低于2.6.0并使用checkbox-group,请参考:

vue
<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,选中后变为trueel-checkbox 标签内的内容将成为复选框按钮后面的描述。

禁用状态

复选框的禁用状态。

设置 disabled 属性。

复选框组

用于绑定为一组的多个复选框,通过检查是否选中来指示是否选中某个选项。

checkbox-group 元素可以通过使用绑定为 Arrayv-model 来管理一组中的多个复选框。在 el-checkbox 元素内,value 是复选框的值。如果该标签中没有嵌套任何内容,则 label 将呈现为复选框按钮后面的描述。 value 也对应于数组中的元素值。如果数组中存在指定的值,则选择该值,反之亦然。

选项属性 2.11.2

el-checkbox-group 基本用法的快捷方式。您可以通过props属性自定义options的别名。

不确定

indeterminate 属性可以帮助您实现“检查全部”效果。

检查的最小/最大项目

minmax 属性可以帮助您限制检查项目的数量。

按钮样式

具有按钮样式的复选框。

您只需将 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 相同,当 indeterminatetrue 时生效 | 字符串 | — | | 咏叹调标签 a11y | 原生 aria-label 属性 | 字符串 | — | | true-label ^(已弃用) | 复选框的值(如果已选中) | 字符串 / 数字 | — | | 错误标签 ^(已弃用) | 复选框的值(如果未选中) | 字符串 / 数字 | — | | 控制 a11y 已弃用 | 与 aria-controls 相同,当 indeterminatetrue 时生效 | 字符串 | — |

复选框事件

名称描述类型
改变绑定值改变时触发功能

复选框槽

名称描述
默认自定义默认内容

复选框组 API

CheckboxGroup 属性

|名称 |描述 |类型 |默认 | | ------------------------ | | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------- | |模型值 / v 模型 |绑定值| 数组 | []| |尺寸|复选框的大小 | 枚举 | — | |已禁用 |嵌套复选框是否被禁用 | 布尔值 |假 | |分钟|选中复选框的最小数量 | 数字 | — | |最大|选中复选框的最大数量 | 数字 | — | |咏叹调标签 a11y 2.7.2 |原生 aria-label 属性 | 字符串 | — | |文本颜色 |按钮激活时的字体颜色 | 字符串 | #ffffff| |填充|按钮处于活动状态时的边框和背景颜色 | 字符串 | #409eff | |标签|复选框组的元素标签 | 字符串 |分区 | |验证事件 |是否触发表单验证 | 布尔值 |真实| |标签 a11y 已弃用 |原生 aria-label 属性 | 字符串 | — | |选项 2.11.2 |选项数据,valuelabeldisabled 的密钥可以通过 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 ^(已弃用) | 复选框的值(如果已选中) | 字符串 / 数字 | — | | 错误标签 ^(已弃用) | 复选框的值(如果未选中) | 字符串 / 数字 | — |

复选框按钮槽

名称描述
默认自定义默认内容