# 设置UI引擎前端页面复选框组组件属性
复选框组组件用于实现多选项配置式批量选择，用户可在一组相关选项中同时选择多个项目。该组件支持数据驱动渲染，适用于设备参数批量配置、工艺方案多选、功能模块组合启用等工业应用场景。
#### 前提条件
已在当前页面添加"复选框组"组件，具体操作请参见[为UI引擎前端页面添加物料组件](https://support.huaweicloud.com/usermanual-idme/idme_ui_0016.html)。
#### 配置入口
1. 在页面设计器的中心画布区，单击选中"复选框组"组件。
2. 在右侧设置面板中，单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002503727160.png)，即可展开"属性"设置面板。
 
#### 基础属性
| 属性名称   | 说明                                                                                                                                                                                                                                                                                                                                                                               | 是否支持变量绑定 |
|:---|:---|:---|
| 绑定值    | 当前选中的选项，返回一个数组，包含所有被选中的选项值。                                                                                                                                                                                                                                                                                                                                                      | 是        |
| 禁用     | 是否禁用整个复选框组。禁用后，组内所有选项均无法进行交互操作。                                                                                                                                                                                                                                                                                                                                                  | 是        |
| 选项列表   | 多选功能的备选项数据源，格式为符合组件要求的对象数组。                                                                                                                                                                                                                                                                                                                                                      | 是        |
| 类型     | 子项组件的呈现形式，可选值为： - checkbox：标准复选框，适用于表单配置。默认为"checkbox"。  - button：按钮式复选框，适用于操作面板、快速选择。   | 是        |
| 最小勾选数量 | 限制用户最少需要勾选的选项个数，未达到数量时无法完成确认操作。                                                                                                                                                                                                                                                                                                                                                  | 是        |
| 最大勾选数量 | 限制用户最多可以勾选的选项个数，达到数量后其余选项将自动置灰不可选。                                                                                                                                                                                                                                                                                                                                               | 是        |
| 按钮填充颜色 | 当"类型"为"button"时，激活状态下按钮的填充色与边框色。 支持颜色单词、RGB格式和十六进制格式。                                                                                                                                                                                                                                                                               | 是        |
| 文字颜色   | 当"类型"为"button"时，激活状态下按钮的文字颜色。 支持颜色单词、RGB格式和十六进制格式。                                                                                                                                                                                                                                                                               | 是        |
| 尺寸     | 复选框组的整体尺寸，仅对"button"类型子项或带有边框的"checkbox"子项生效。                                                                                                                                                                                                                                                                                                                                    | 否        |
| 垂直排列   | 设置复选框是否垂直排列。开启后选项将垂直分布，关闭时为水平分布。                                                                                                                                                                                                                                                                                                                                                 | 是        |
   
#### 其他
如下属性适用于UI引擎所有组件，用于精细化控制。
| 属性名称   | 说明                                                                                                                                 | 是否支持变量绑定 |
|:---|:---|:---|
| 元素id值  | 对应HTML标签的"id"属性，同一页面内必须唯一。                                                                                                         | 是        |
| 样式类    | 对应HTML标签的"class"属性，为空格分隔的类名列表，用于自定义组件样式。默认为"component-base-style"。                                                                 | 是        |
| ref引用类 | 对应Vue的"ref"属性，用于注册模板引用以访问组件实例方法。 如果为"数据源表单"组件，会自动填充默认值。 | 是        |