Skip to content

Checkbox 多选框

该组件是低代码平台中用于多选项选择的表单项,基于 Element Plus 的 <el-checkbox-group><el-checkbox-button> 封装,支持本地字典、远程加载、数量限制及按钮样式切换,并深度集成表单容器(<el-form>)的数据绑定与校验体系。

基础属性

属性类型说明
选项组件类型 typeenum可选:checkbox(标准复选框)、button(按钮式复选框)
是否仅显示图标 onlyIconboolean仅在选项配置了图标时生效,隐藏文字标签
最小选择数量 minnumber至少需选择的选项数(整数,≥0)
最大选择数量 maxnumber最多可选择的选项数(整数,≥0)
是否远程加载 remoteboolean启用后从函数动态加载选项
字典类型 dictTypestring本地数据源标识,用于加载预设选项(仅当未启用远程加载时生效)
选项加载函数 remoteMethodfunction远程模式下调用;需返回 { label, value, icon, disabled } 格式的选项数组(异步支持)
表单项基础配置包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine

高级属性

属性类型说明
表单项高级配置包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine

事件

事件触发时机说明
change所选值发生变化时对应 Element Plus 的 change 事件