代码画面
代码画面用于自定义布局和展示交互。新建页面时选择“代码画面”,在 Monaco 中编辑 HTML、CSS 和页面 JavaScript,并同步查看预览。发布后与拖拽页一同落到 C:\Darra\HMI\。
重要规则
| 规则 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 页面类型 | 设计器 | 只写一次 | 不能转换为拖拽画面,也不会反向生成拖拽控件模型 |
| 页面 JavaScript | 脚本 | 读 + 受控写 | 只处理展示、导航和经过授权的操作请求 |
| 公开入口 | 脚本 | 读 + 受控写 | 小写 window.darra,不要使用 window.Darra,不要直接操作 WebSocket |
| 控制逻辑 | PLC | 读写 | 设备状态机、联锁、顺序和安全必须用 SCL |
编辑区
| 文件 | 类别 | 读写 | 用途 |
|---|---|---|---|
index.html | 页面结构 | 读写 | 页面结构和 HMI 自定义控件 |
page.css | 样式 | 读写 | 当前页面样式 |
page.js | 脚本 | 读写 | 当前页面展示逻辑 |
shared.css | 项目共享 | 读写 | 项目级共享样式 |
shared.js | 项目共享 | 读写 | 项目级共享页面函数 |
Monaco 不可用时,编辑器回退到 HTML、CSS 和 JavaScript 三个文本标签页。
常用命令
| 命令 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 保存 | 项目 | 写 | 写回当前页面到 .dplc |
| 浏览器预览 | 预览 | 只读 | 合成共享样式、页面内容和共享脚本 |
| 刷新预览 | 预览 | 只读 | 更新右侧内嵌预览 |
| 格式化当前 / 全部 | 编辑 | 写 | 整理当前文件或所有页面文件 |
| 私有脚本库 | 脚本 | 读写 | 编辑项目级共享页面函数 |
| 全屏 | 编辑 | 读写 | 扩大代码和预览区域 |
自定义元素
优先使用声明式绑定,减少手写订阅和 DOM 更新。
| 元素 | 类别 | 读写 | 属性 | 说明 |
|---|---|---|---|---|
<darra-led> | 显示 | 只读 | var、color-on、color-off | 指示灯 |
<darra-label> | 显示 | 只读 | var、unit | 标签 |
<darra-numeric> | 显示 | 只读 | var | 数字显示 |
<darra-input> | 操作 | 读写 | var、type、min、max、step | 输入框 |
<darra-button> | 操作 | 写请求 | var、action、on-value、off-value | 按钮 |
<darra-gauge> | 显示 | 只读 | var | 仪表 |
<darra-trend> | 显示 | 只读 | vars | 趋势 |
<darra-alarm-list> | 报警 | 读 + 确认 | — | 报警列表 |
<darra-image-toggle> | 显示 | 只读 | var | 图片切换 |
<section class="motor-card">
<h2>主电机</h2>
<darra-led var="DB1.MotorRunning"
color-on="#00E676"
color-off="#4A4A55"></darra-led>
<darra-label var="DB1.Speed" unit="r/min"></darra-label>
<darra-input var="DB1.SpeedSetpoint"
type="number"
min="0" max="3000" step="10"></darra-input>
<darra-button var="DB1.StartRequest"
action="momentary"
on-value="1" off-value="0">启动请求</darra-button>
</section>
通用 data-* 属性(代码名、可见、使能、只读、权限)见 控件库。
CSS
.motor-card {
display: grid;
grid-template-columns: repeat(2, minmax(0, 1fr));
gap: 16px;
padding: 20px;
}
@media (max-width: 900px) {
.motor-card { grid-template-columns: 1fr; }
}
动画优先使用 transform 和 opacity,避免高频改变布局尺寸。
页面 JavaScript
| 适合 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 切换纯界面面板或标签页 | 界面 | 读写 | 不改变 PLC 状态 |
| 格式化展示数据 | 显示 | 只读 | 可用绑定表达式代替 |
| 预览中的临时 UI 状态 | HMI 变量 | 读写 | hmi.page.* 或局部变量 |
| 调用项目共享页面函数 | 脚本 | 读 | shared.js |
| 释放计时器和监听器 | 生命周期 | 写清理 | 离开页面时必须释放 |
| 不应做 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 设备启停条件 | 控制 | 禁止 | 放在 PLC SCL |
| 故障复位条件 | 控制 | 禁止 | 放在 PLC SCL |
| 工艺步骤 | 控制 | 禁止 | 放在 PLC SCL |
| 直接创建 WebSocket | 通讯 | 禁止 | 只通过 window.darra |
需要派生过程值时,优先使用 C# 风格的只读 SCL 绑定表达式。
window.darra 最小集
| API | 类别 | 读写 | 说明 |
|---|---|---|---|
darra.bind(name, callback) | 变量 | 读 | 值变化回调;返回取消函数 |
darra.get(name) | 变量 | 读 | 已订阅缓存 |
darra.write(name, value) | 变量 | 写 | 事务写入,须等回执 |
darra.writeGroup(values) | 变量 | 写 | 同一事务批量写入 |
darra.navigate(route) | 页面 | 写 | 例如 darra.navigate('/alarm') |
darra.on('ready'|'offline'|'error', cb) | 事件 | 读 | 连接状态 |
darra.ctl(name) | 控件 | 读 | 按代码名取元素,未找到返回 null |
darra.setTheme(name) | 主题 | 写 | 仅 modern / industrial |
darra.getTheme() | 主题 | 读 | 当前主题名 |
完整合同见 HMI 脚本 API。darra.pulse() 当前拒绝。
预览和现场检查
离线预览用于检查 HTML、CSS、控件加载和响应式布局。连接已部署运行时后,再验证变量更新、写入拒绝、断线状态和权限。
| 检查 | 类别 | 读写 | 判据 |
|---|---|---|---|
| 变量来源 | 数据 | 只读检查 | 全部来自当前项目 |
| 写控件 | 操作 | 写检查 | 有明确范围和权限 |
| 轮询 | 脚本 | 禁止 | 无持续高频轮询 |
| 生命周期 | 脚本 | 写清理 | 离开页面时释放计时器和监听器 |
| 控制逻辑 | PLC | 读写 | 仍由 SCL 独立完成 |