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