跳到主要内容

属性绑定

属性绑定用于让控件的文本、数值、可见性或样式随数据变化。主变量绑定不足以表达显示需求时,在属性面板中为目标属性单独配置。

运行时由 window.darra 推送变量;属性绑定只消费已订阅值。现场包在 C:\Darra\HMI\。

四种模式​

模式类别读写示例
常量属性只读运行状态
PLC 变量属性只读,或写控件读写DB1.Speed
表达式属性只读DB1.Run && !DB1.Fault
页面脚本属性只读展示仅代码画面;不实现 PLC 控制逻辑

现场画面优先使用常量、PLC 变量和表达式。页面脚本应保持少量、可预览,并与 PLC SCL 分离。脚本入口是小写 window.darra。

可绑定属性​

属性类别读写说明
文本 / 当前值显示只读,输入控件读写主显示内容
可见性显示只读驱动对应 data-visible
使能交互只读驱动对应 data-enabled
只读交互只读驱动对应 data-readonly
前景色 / 背景色 / 边框色外观只读驱动优先用动画编辑器
位置、尺寸、旋转、透明度几何只读驱动优先用动画编辑器
液位、进度显示只读数值过程量
状态文本显示只读离散映射

动态位置、尺寸、颜色、闪烁和液位优先使用动画绑定编辑器;它提供直传、离散映射和区间映射,比手写页面脚本更容易验证。

配置步骤​

  1. 选中控件。
  2. 在属性面板找到目标属性。
  3. 打开该属性的绑定编辑器。
  4. 选择常量、PLC 变量或表达式。
  5. 需要时设置格式和回退值。
  6. 预览结果并保存页面。

PLC 变量模式可从项目变量树搜索和选择,避免手输错误名称。

格式与回退​

参数类别读写示例
格式显示读写0.00
回退值显示读写空值、异常或未就绪时显示 --
刷新间隔运行读写表达式属性检查周期,默认 200 ms

显示属性可以使用较长刷新间隔;快速变化的过程值应使用主变量绑定或趋势控件。

示例​

文本​

项类别读写值
属性显示只读文本
模式绑定只读PLC 变量
来源数据只读DB1.Speed
格式显示读写0.0
回退显示读写--

可见性​

项类别读写值
属性显示只读驱动可见
模式绑定只读表达式
来源数据只读DB1.MaintenanceMode && !DB1.Fault
回退显示读写false

状态颜色​

离散状态不建议堆叠条件表达式。使用映射模式:

0 → #5A6573
1 → #2E9B5B
2 → #D64545

数值区间​

液位或进度使用区间映射:

输入 0..100 → 输出 0..100

写属性​

输入、滑块、旋钮和开关可以提交值。配置前确认:

检查类别读写说明
目标变量允许写入数据写检查项目白名单
控件未只读或禁用交互写检查data-readonly / data-enabled
用户具备所需权限安全写检查data-darra-permission
数值范围和步进量程写检查与 PLC 定义一致
PLC SCL 校验控制写检查范围、联锁和设备状态由 PLC 独立处理

相关文档​