Checkbox 多选框
该组件是低代码平台中用于多选项选择的表单项,基于 Element Plus 的 <el-checkbox-group> 及 <el-checkbox-button> 封装,支持本地字典、远程加载、数量限制及按钮样式切换,并深度集成表单容器(<el-form>)的数据绑定与校验体系。
基础属性
| 属性 | 类型 | 说明 |
|---|---|---|
选项组件类型 type | enum | 可选:checkbox(标准复选框)、button(按钮式复选框) |
是否仅显示图标 onlyIcon | boolean | 仅在选项配置了图标时生效,隐藏文字标签 |
最小选择数量 min | number | 至少需选择的选项数(整数,≥0) |
最大选择数量 max | number | 最多可选择的选项数(整数,≥0) |
是否远程加载 remote | boolean | 启用后从函数动态加载选项 |
字典类型 dictType | string | 本地数据源标识,用于加载预设选项(仅当未启用远程加载时生效) |
选项加载函数 remoteMethod | function | 远程模式下调用;需返回 { label, value, icon, disabled } 格式的选项数组(异步支持) |
| 表单项基础配置 | — | 包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine) |
高级属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 表单项高级配置 | — | 包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine) |
事件
| 事件 | 触发时机 | 说明 |
|---|---|---|
change | 所选值发生变化时 | 对应 Element Plus 的 change 事件 |
