设置UI引擎前端页面按钮组件属性
按钮组件是UI引擎提供的基础交互工具之一，用于触发各种操作（如启动设备、提交数据或切换状态）。通过灵活的属性配置，按钮组件能够满足不同场景下的需求。
前提条件
已在当前页面添加“按钮”组件，具体操作请参见为UI引擎前端页面添加物料组件。
配置入口
- 在页面设计器的中心画布区，单击选中“按钮”组件。
- 在右侧设置面板中，单击
，即可展开“属性”设置面板。
基础属性
此部分的属性用于定义按钮的显示文本、尺寸、类型及交互状态，适配工业场景下的多样化操作需求。
|
属性名称 |
说明 |
是否支持变量绑定 |
|---|---|---|
|
按钮文字 |
定义展示给用户的文案内容。 如需设置为纯图标按钮，清空文字内容即可。 |
是 |
|
大小 |
按钮的尺寸设置，可选值：
|
是 |
|
类型 |
定义按钮的类型，不同类型的按钮会呈现不同的样式。可选项包括：
|
是 |
|
禁用 |
控制按钮是否禁用，默认关闭。开启后按钮不可单击，适用于设备状态不满足操作条件的场景。 通常需要配合状态变量使用（如{{deviceStatus}}!=='ready'）。 |
是 |
|
圆角 |
控制按钮是否为圆角样式，默认关闭。 开启后按钮边角圆润，适用于提升页面视觉美观度。 |
是 |
|
朴素按钮 |
控制按钮是否为朴素样式，默认关闭。 开启后按钮背景色更浅，适用于次要操作按钮（如辅助查询）。 |
是 |
|
禁用时间 |
设置按钮单击后的禁用时长（单位：毫秒），默认为0。 用于防止重复提交操作（如设备启动指令重复发送），提升操作安全性。 |
是 |
|
圆形按钮 |
控制按钮是否为圆形样式。 开启后按钮呈圆形，适用于紧凑布局的操作按钮（如设备状态切换图标）。 |
是 |
|
自动聚焦 |
设置按钮是否默认聚焦，默认关闭。 开启后页面加载完成后按钮自动获得焦点，适用于需要用户立即操作的场景（如设备故障确认按钮）。 |
是 |
|
加载中样式 |
控制按钮是否显示加载中状态，默认关闭。 开启后按钮显示加载动画，适用于操作需要等待后台响应的场景（如设备启动指令提交中）。 |
是 |
图标信息
图标信息属性用于定义按钮中的图标样式，增强按钮的视觉辨识度与操作引导性。
|
属性名称 |
说明 |
是否支持变量绑定 |
|---|---|---|
|
图标 |
选择按钮中显示的图标，可通过图标选择面板搜索并选中目标图标（如搜索Start选择启动图标、搜索Stop选择停止图标）。 |
是 |
|
图标颜色 |
设置按钮图标的显示颜色，可配置为具体颜色值（如“#ff0000”红色）或变量绑定。适用于通过颜色区分按钮状态（如启动图标为绿色、停止图标为红色）。 |
是 |
|
图标大小 |
设置图标的大小，单位为像素（px），最小值为10，默认值为14。 |
是 |
其他
如下属性适用于UI引擎所有组件，用于精细化控制。
|
属性名称 |
说明 |
是否支持变量绑定 |
|---|---|---|
|
元素id值 |
对应HTML标签的“id”属性，同一页面内必须唯一。 |
是 |
|
样式类 |
对应HTML标签的“class”属性，为空格分隔的类名列表，用于自定义组件样式。默认为“component-base-style”。 |
是 |
|
ref引用类 |
对应Vue的“ref”属性，用于注册模板引用以访问组件实例方法。 如果为“数据源表单”组件，会自动填充默认值。 |
是 |
