el-checkbox 是 Element Plus 提供的复选框组件,用于让用户从一组选项中做多项选择,也可用于状态切换、全选功能和表单多选字段。
主要能力:单个复选框通过 v-model 绑定选中值,支持 disabled 禁用、border 加边框、size 设置尺寸;el-checkbox-group 用于成组多选,v-model 绑定数组,可通过 options 属性直接传入选项数据,或用 props 配置字段;支持 min/max 限制最少与最多可选数量;indeterminate 属性用于实现全选时的半选状态;el-checkbox-button 提供按钮样式。
基本用法:单个使用写 <el-checkbox v-model="checked">Option</el-checkbox>;分组使用写 <el-checkbox-group v-model="checkList"> 并在其中放置多个 el-checkbox,每个通过 value 指定值。全选场景通常配合 indeterminate 与 change 事件,在事件回调中同步全选状态与已选项数组。
适用场景:表单中的多选字段、筛选条件、权限或标签选择、需要全选/半选交互的列表。
限制与注意:自 2.6.0 起,复选框的值应使用 value 属性而非 label;min/max 仅限制选择数量,具体行为需自行处理;资料未提供收费、平台支持范围等其它信息。