# 设置UI引擎前端页面开关组件属性
开关组件用于实现两种状态之间的快速切换，广泛应用于设备启停控制、模式切换、参数开关等场景。本组件支持自定义开关值、显示文字、迷你尺寸等配置，适用于工业控制系统的人机交互界面。
#### 前提条件
已在当前页面添加"开关"组件，具体操作请参见[为UI引擎前端页面添加物料组件](https://support.huaweicloud.com/usermanual-idme/idme_ui_0016.html)。
#### 配置入口
1. 在页面设计器的中心画布区，单击选中"开关"组件。
2. 在右侧设置面板中，单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002503567334.png)，即可展开"属性"设置面板。
 
#### 基础属性
| 属性名称  | 说明                                                                                                                            | 是否支持变量绑定 |
|:---|:---|:---|
| 禁用    | 是否禁用组件。可根据设备状态、操作权限、工艺流程阶段动态控制开关可用性。                                                                                          | 是        |
| 绑定值   | 组件绑定的值，用于反映和控制开关的当前状态。                                                                                                        | 是        |
| 显示文字  | 是否在组件内显示文字。开启后，默认开启状态显示为"on"，关闭状态显示为"off"。可结合插槽功能自定义文案。 **注意：**开启"迷你尺寸"时，此属性无效。 | 是        |
| 设置打开值 | 打开状态下绑定的值。不填时，默认为"true"。 **注意：**如需绑定值为布尔类型，请保持为空，不要输入任何值。输入的内容将被转换为字符串。         | 是        |
| 设置关闭值 | 关闭状态下绑定的值。不填时，默认为"false"。 **注意：**如需绑定值为布尔类型，请保持为空，不要输入任何值。输入的内容将被转换为字符串。          | 是        |
| 迷你尺寸  | 是否使用迷你尺寸开关。 **注意：**开启后，"显示文字"属性和插槽功能将失效。                                       | 是        |
   
#### 其他
如下属性适用于UI引擎所有组件，用于精细化控制。
| 属性名称   | 说明                                                                                                                                 | 是否支持变量绑定 |
|:---|:---|:---|
| 元素id值  | 对应HTML标签的"id"属性，同一页面内必须唯一。                                                                                                         | 是        |
| 样式类    | 对应HTML标签的"class"属性，为空格分隔的类名列表，用于自定义组件样式。默认为"component-base-style"。                                                                 | 是        |
| ref引用类 | 对应Vue的"ref"属性，用于注册模板引用以访问组件实例方法。 如果为"数据源表单"组件，会自动填充默认值。 | 是        |
   
#### 插槽信息
插槽用于在组件指定位置插入自定义内容，实现更灵活的界面定制。
| 插槽名称  | 说明                                                                                             |
|:---|:---|
| close | 关闭状态下的插槽，用于自定义关闭状态的文案。 仅在"显示文字"启用且尺寸不为"迷你"时有效。   |
| open  | 打开状态下的插槽，用于自定义打开状态的文案。 仅在"显示文字"启用且尺寸不为"迷你"时有效。 |