更新时间:2026-03-16 GMT+08:00
分享

设置UI引擎前端页面复选框组件属性

复选框组件用于实现多选项配置,允许用户从一组相关选项中选择多个项目。本组件支持标准勾选、半选状态、自定义选中值、边框样式等功能,适用于设备参数配置、工艺选项选择、功能模块启用等工业应用场景。

前提条件

已在当前页面添加“复选框”组件,具体操作请参见为UI引擎前端页面添加物料组件

配置入口

  1. 在页面设计器的中心画布区,单击选中“复选框”组件。
  2. 在右侧设置面板中,单击,即可展开“属性”设置面板。

基础属性

属性名称

说明

是否支持变量绑定

绑定值

组件绑定的值,用于反映和控制复选框的当前选中状态。

禁用

是否禁用组件。禁用后,组件将无法进行交互操作。

勾选

是否设置复选框为勾选状态。

半选

是否设置复选框为半选状态,此属性仅负责样式控制,不影响绑定值的逻辑。

文本

复选框右侧显示的文本标签。

其他

属性名称

说明

是否支持变量绑定

元素id值

对应HTML标签的“id”属性,同一页面内必须唯一。

样式类

对应HTML标签的“class”属性,为空格分隔的类名列表,用于自定义组件样式。默认为“component-base-style”

ref引用类

对应Vue的“ref”属性,用于注册模板引用以访问组件实例方法。

如果为“数据源表单”组件,会自动填充默认值。

边框

复选框是否显示边框。

尺寸

在设置了“边框”属性时,用于设置复选框的尺寸。

未选中的值

未选中时,绑定值所对应的值。配置此属性可以使未选中状态的值不再固定为“false”

选择时的值

选中时,绑定值所对应的值。配置此属性可以使选中状态的值不再固定为“true”

相关文档