
# 设置UI引擎前端页面复选框组件属性
复选框组件用于实现多选项配置，允许用户从一组相关选项中选择多个项目。本组件支持标准勾选、半选状态、自定义选中值、边框样式等功能，适用于设备参数配置、工艺选项选择、功能模块启用等工业应用场景。
#### 前提条件
已在当前页面添加"复选框"组件，具体操作请参见[为UI引擎前端页面添加物料组件](https://support.huaweicloud.com/usermanual-idme/idme_ui_0016.html)。
#### 配置入口
1. 在页面设计器的中心画布区，单击选中"复选框"组件。
2. 在右侧设置面板中，单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002535567159.png)，即可展开"属性"设置面板。
 
#### 基础属性
| 属性名称 | 说明                                 | 是否支持变量绑定 |
|:---|:---|:---|
| 绑定值  | 组件绑定的值，用于反映和控制复选框的当前选中状态。          | 是        |
| 禁用   | 是否禁用组件。禁用后，组件将无法进行交互操作。            | 是        |
| 勾选   | 是否设置复选框为勾选状态。                      | 是        |
| 半选   | 是否设置复选框为半选状态，此属性仅负责样式控制，不影响绑定值的逻辑。 | 是        |
| 文本   | 复选框右侧显示的文本标签。                      | 是        |
   
#### 其他
| 属性名称   | 说明                                                                                                                                 | 是否支持变量绑定 |
|:---|:---|:---|
| 元素id值  | 对应HTML标签的"id"属性，同一页面内必须唯一。                                                                                                         | 是        |
| 样式类    | 对应HTML标签的"class"属性，为空格分隔的类名列表，用于自定义组件样式。默认为"component-base-style"。                                                                 | 是        |
| ref引用类 | 对应Vue的"ref"属性，用于注册模板引用以访问组件实例方法。 如果为"数据源表单"组件，会自动填充默认值。 | 是        |
| 边框     | 复选框是否显示边框。                                                                                                                         | 是        |
| 尺寸     | 在设置了"边框"属性时，用于设置复选框的尺寸。                                                                                                            | 否        |
| 未选中的值  | 未选中时，绑定值所对应的值。配置此属性可以使未选中状态的值不再固定为"false"。                                                                                         | 是        |
| 选择时的值  | 选中时，绑定值所对应的值。配置此属性可以使选中状态的值不再固定为"true"。                                                                                            | 是        |
   
