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