跳到主要内容

代码画面

代码画面用于自定义布局和展示交互。新建页面时选择“代码画面”,在 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 独立完成

相关文档​