跳到主要内容

拖拽页与代码页协作

同一 HMI 项目中可以同时有拖拽页和代码页。部分页面适合快速拖拽,另一些需要自定义 HTML / CSS / window.darra 时使用本页。两类页面发布到同一现场目录 C:\Darra\HMI\。

没有同页混合模式​

拖拽画面和代码画面在创建时定型,不能互转,也不能先拖拽后进入源码继续编辑同一页面。这样可以避免控件位置、源码和运行结果出现有损往返。

需求类别读写正确做法
常规操作页页面设计读写新建拖拽画面
自定义布局页页面设计读写新建代码画面
两种页面保持统一项目读写共享主题、变量、导航和页面函数
页面类型选错页面只写新页新建正确类型页面并手工迁移必要内容

可共享内容​

内容类别读写说明
PLC 命名变量过程数据读,或受控写两类页面绑定同一符号;类型和权限以 PLC 项目为准
直接地址过程数据读,或受控写仅在项目已确认含义时使用
hmi.global.名称HMI 变量读写跨页面纯界面状态
hmi.page.页面.名称HMI 变量读写仅当前页;同名页级变量彼此独立
项目主题外观读写所有页面共享;代码画面不要把状态色写死
页面路由 / 首页导航读写路由唯一,首页只能一个
项目级 shared.js / shared.css脚本读写仅服务 HMI 页面,不承担 PLC 控制逻辑
window.darra脚本 API读 + 受控写代码画面与事件脚本的公开入口

不要把页级变量当作跨页状态。需要 PLC 参与的状态必须使用 PLC 变量。

推荐拆分​

页面类别读写类型原因
设备总览监控以读为主拖拽画面固定控件多,绑定配置为主
报警页报警读 + 确认拖拽画面使用标准报警控件
趋势页趋势只读拖拽画面使用标准趋势和状态控件
专用可视化自定义读 + 受控写代码画面需要自定义 HTML、CSS 或绘制逻辑

标准 6 页路由 main / alarm / trend / recipe / users / settings 也可按上表选型。

一致性检查​

检查类别读写判据
路由导航只读检查没有重复
单位和状态色显示只读检查同一 PLC 变量在不同页面中一致
写控件操作写检查只绑定必要的请求或设定变量
HMI 变量数据读写检查全局与页级没有混用
页面脚本脚本只读检查不复制 PLC SCL 状态机
预览预览只读两类页面在目标主题和分辨率下分别预览

迁移注意​

如果页面类型选错,不要复制生成后的内部数据或尝试强制切换模式。建立正确类型的新页面,只迁移可验证的文本、变量名、颜色、尺寸和业务说明,然后重新配置绑定与事件。代码画面脚本仍使用小写 window.darra。

相关文档​