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

