跳到主要内容

HMI 事件

HMI 事件用于响应点击、输入、加载和页面交互。内置控件动作无法完成所需界面行为时,再为控件配置事件。

事件脚本入口是小写 window.darra。高级事件使用设计器生成的 context,不要自行构造或绕过写权限。现场包在 C:\Darra\HMI\。

优先使用内置动作​

动作类别读写说明
自复位 momentary操作写按下写入按下值,松开写回松开值
置位 set操作写写入按下值
复位 reset操作写写入松开值
取反 toggle操作写在两值之间切换
打印 print操作只读动作打印当前页、指定页或报表区
页面跳转导航写导航到指定页面

输入框、滑块、旋钮和开关也有内置提交行为。能用内置动作时,不要重复写事件脚本。

拖拽画面的控件事件​

事件编辑器根据控件类型显示可用事件。属性名为 data-on-<event>,可选 data-on-<event>-lang(默认 js)。

控件族类别读写常用事件
按钮、图片切换、面板、标签交互读事件 / 写动作点击、双击、按下、释放、悬停、加载、卸载
输入和数值控件输入读写值变化、获得焦点、失去焦点、加载、卸载
滑块和进度条输入读写值变化、加载
指示灯显示只读加载、值变化
仪表、趋势、图表和报警列表显示只读加载、卸载
其他控件交互读事件点击、加载

控件只显示自身支持的事件。不要假设所有控件都有相同事件。

配置步骤​

  1. 在画布中选中控件。
  2. 打开事件属性。
  3. 选择事件名称。
  4. 优先选择页面动作或控件内置动作。
  5. 必须写 PLC 请求时,使用项目采用的 C# 风格 SCL,并保持单一、短小的请求赋值。
  6. 保存后在离线预览中检查界面效果,再连接运行时验证写入。

事件职责​

可以做类别读写说明
打开或关闭纯界面面板界面读写不改变 PLC 状态
切换标签页或页面导航写darra.navigate 或内置跳转
提交一个经过授权的请求变量操作写等完整回执
显示确认提示安全只读危险操作
启动或停止纯显示动画外观只读驱动不判断设备状态
清理计时器和监听器生命周期写清理页面卸载时
不应做类别读写说明
在 HMI 中实现设备状态机控制禁止放在 PLC SCL
判断安全联锁控制禁止放在 PLC SCL
直接组合多个输出形成启停序列控制禁止只提交请求变量
用页面计时器代替 PLC 定时器控制禁止扫描周期在 Service
用本地 UI 状态冒充 PLC 真实状态显示禁止状态来自 PLC 变量

设备动作应采用“页面提交请求 → PLC SCL 校验 → PLC 更新状态 → HMI 显示结果”的闭环。

代码画面与 window.darra​

代码画面可以使用浏览器事件处理界面交互,但 PLC 写入仍应通过受控 API 完成。

API类别读写说明
darra.on(event, callback)运行时事件读返回取消函数
darra.off(event, callback)运行时事件写清理移除指定监听器
darra.write(name, value)变量写单变量事务
darra.writeGroup(values)变量写同一事务批量
darra.isCommittedReceipt(receipt)变量读判断是否完整提交
darra.navigate(route)页面写页面跳转
darra.ctl(name)控件读按代码名取元素

常用运行时事件:

事件类别读写说明
ready连接只读WebSocket 已连接
offline连接只读已断开;应禁用写入
error诊断只读运行时错误
write_receipt写入只读写入回执
themeChanged主题只读主题切换
alarm.added报警只读新报警
alarm.updated报警只读报警更新
alarm.acknowledged报警只读已确认
alarm.cleared报警只读已清除

创建的计时器、订阅和事件监听器应在页面离开时释放。

高级事件脚本​

设计器编译的高级事件脚本会收到受控 context:

API类别读写说明
context.plc.read()变量读主动读取
context.plc.write()变量写受声明白名单约束
context.plc.subscribe()变量读订阅
context.events.on() / off() / once()事件读可配超时和重入
context.navigation.go()页面写跳转
context.alarms.acknowledge() / clear() / list()报警读 + 确认报警操作
context.i18n / context.log / context.clock辅助读翻译、日志、时钟
context.signal / context.abort()生命周期写取消进行中的处理

重入策略:serial、drop、merge。优先让设计器生成上下文。

危险操作​

规则类别读写说明
自复位或显式确认安全写危险动作
显示将要执行的动作和目标设备安全只读操作前可见
断线 / 只读 / 禁用 / 权限不足安全禁止写拒绝操作
PLC SCL 再检查控制读写设备状态和联锁
无旁路安全禁止HMI 不提供绕过 PLC 安全逻辑的路径

验收​

检查类别读写期望
单击一次交互写只触发一次动作
自复位按钮操作写鼠标和触摸抬起都恢复松开值
重新进入页面生命周期读没有重复事件
断线运行禁止写写事件被禁用
权限不足安全禁止写动作不可执行
PLC 拒绝操作读回执界面明确提示失败,不伪装成功

相关文档​