属性绑定
属性绑定用于让控件的文本、数值、可见性或样式随数据变化。主变量绑定不足以表达显示需求时,在属性面板中为目标属性单独配置。
运行时由 window.darra 推送变量;属性绑定只消费已订阅值。现场包在 C:\Darra\HMI\。
四种模式
| 模式 | 类别 | 读写 | 示例 |
|---|---|---|---|
| 常量 | 属性 | 只读 | 运行状态 |
| PLC 变量 | 属性 | 只读,或写控件读写 | DB1.Speed |
| 表达式 | 属性 | 只读 | DB1.Run && !DB1.Fault |
| 页面脚本 | 属性 | 只读展示 | 仅代码画面;不实现 PLC 控制逻辑 |
现场画面优先使用常量、PLC 变量和表达式。页面脚本应保持少量、可预览,并与 PLC SCL 分离。脚本入口是小写 window.darra。
可绑定属性
| 属性 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 文本 / 当前值 | 显示 | 只读,输入控件读写 | 主显示内容 |
| 可见性 | 显示 | 只读驱动 | 对应 data-visible |
| 使能 | 交互 | 只读驱动 | 对应 data-enabled |
| 只读 | 交互 | 只读驱动 | 对应 data-readonly |
| 前景色 / 背景色 / 边框色 | 外观 | 只读驱动 | 优先用动画编辑器 |
| 位置、尺寸、旋转、透明度 | 几何 | 只读驱动 | 优先用动画编辑器 |
| 液位、进度 | 显示 | 只读 | 数值过程量 |
| 状态文本 | 显示 | 只读 | 离散映射 |
动态位置、尺寸、颜色、闪烁和液位优先使用动画绑定编辑器;它提供直传、离散映射和区间映射,比手写页面脚本更容易验证。
配置步骤
- 选中控件。
- 在属性面板找到目标属性。
- 打开该属性的绑定编辑器。
- 选择常量、PLC 变量或表达式。
- 需要时设置格式和回退值。
- 预览结果并保存页面。
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 独立处理 |