拖拽页与代码页协作
同一 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。