拖拽画面用于固定布局的设备界面。新建页面时选择“拖拽画面”,之后在 GrapesJS 画布和独立属性面板中完成编辑。发布后页面随项目落到现场 C:\Darra\HMI\。
重要规则
| 规则 | 类别 | 读写 | 说明 |
|---|
| 页面类型 | 设计器 | 只写一次 | 拖拽画面与代码画面不能互转 |
| 源码入口 | 设计器 | 无 | 拖拽画面不开放 HTML / CSS / JavaScript 编辑 |
| 脚本 | 运行 | 受控写 | 需要源码时新建代码画面,入口为 window.darra |
| 控制逻辑 | PLC | 读写 | 联锁、顺序和安全只在 SCL 中 |
创建页面
- 新建 HMI 页面。
- 填写页面名、标题、路由和首页设置。
- 选择“拖拽画面”。
- 选择空白页面或一个拖拽模板。
- 继承项目分辨率,或为当前页单独设置。
| 项目 | 类别 | 读写 | 说明 |
|---|
| 页面名 / 标题 / 路由 | 页面 | 读写 | 路由项目内唯一 |
| 首页 | 页面 | 读写 | 只能指定一个 |
| 模板 | 设计器 | 只读选择 | 空白或拖拽模板 |
| 分辨率 | 画布 | 读写 | 继承或单页覆盖 |
放置控件
| 步骤 | 类别 | 读写 | 说明 |
|---|
| 从工具箱拖入 | 控件 | 写 | 生成实例 |
| 移动和缩放 | 几何 | 读写 | 默认 8 px 网格吸附 |
| 填文本、量程、单位 | 属性 | 读写 | 属性面板 |
| 锁定背景和装饰 | 设计期 | 写 | 避免误拖 |
| 图层检查 | 图层 | 读写 | 嵌套关系和前后层级 |
| 对齐 / 等间距 | 几何 | 写 | 多选后执行 |
| 方向键 | 几何 | 写 | 精确移动 |
绑定数据
变量可以从项目变量树拖到控件,也可以通过数据绑定向导选择。
| 控件族 | 类别 | 读写 | 绑定类型 |
|---|
| 指示灯、复选框、开关 | 状态 | 读,或读写 | BOOL |
| 仪表、液位、进度条 | 过程值 | 只读 | 数值 |
| 滑块、旋钮 | 设定值 | 读写 | 数值 |
| 标签 | 显示 | 只读 | 字符串或数值 |
| 输入框 | 设定值 | 读写 | 字符串或数值 |
| 趋势 | 历史 | 只读 | 一个或多个数值变量 |
| 表格 | 集合 | 只读 | 数组或记录集合 |
| 自复位 / 置位 / 复位按钮 | 请求 | 只写 | BOOL 请求变量 |
写控件只应绑定请求、设定值或确认变量。不要把 HMI 按钮直接当作设备联锁。
按钮动作
| 动作 | 类别 | 读写 | 行为 |
|---|
momentary | 操作 | 写 | 按下写入按下值,松开写回松开值 |
set | 操作 | 写 | 写入按下值 |
reset | 操作 | 写 | 写入松开值 |
toggle | 操作 | 写 | 在两值之间取反 |
print | 操作 | 只读动作 | 打印当前页、指定页或报表区 |
输入与状态
| 控件 | 类别 | 读写 | 说明 |
|---|
| 输入框 | 输入 | 读写 | 数字或文本;数字可配最小、最大、步进、单位和写入确认 |
| 状态显示 | 显示 | 只读 | 离散映射把 PLC 状态值转为文字和颜色 |
动画和事件
| 能力 | 类别 | 读写 | 说明 |
|---|
| 显隐 / 颜色 / 位置 / 尺寸 | 动画 | 只读驱动 | 变量驱动外观 |
| 旋转 / 透明度 / 液位 / 闪烁 / 文本 | 动画 | 只读驱动 | 见 动画绑定 |
| 内置动作 | 事件 | 写请求 | 优先于事件脚本 |
| 事件脚本 | 事件 | 受控写 | 保持短小;入口 window.darra |
保存内容
| 项 | 类别 | 读写 | 说明 |
|---|
| 控件类型和代码名 | 模型 | 读写 | 页内唯一代码名 |
| 位置、尺寸和层级 | 几何 | 读写 | 百分比几何 |
| 通用属性和专用参数 | 属性 | 读写 | 可见、使能、只读、权限 |
| 变量绑定、事件和动画 | 绑定 | 读写 | 随 .dplc 保存 |
| 设计器状态 | 设计器 | 读写 | 网格、缩放、选中 |
保存后关闭并重新打开页面,确认布局和绑定可完整恢复。
预览与验收
离线预览检查布局、主题和动画外观。连接已部署运行时后再验证:
| 检查 | 类别 | 读写 | 期望 |
|---|
| 断线 | 运行 | 禁止写 | 写控件停止操作 |
| 自复位按钮 | 操作 | 写 | 松开后恢复松开值 |
| 输入范围 | 输入 | 写 | 超出范围拒绝 |
| 权限不足 | 安全 | 只读 | 控件只读或不可操作 |
| PLC 联锁 | PLC | 读写 | SCL 独立执行状态转换和安全处理 |
相关文档