HMI 控件库
HMI 控件库用于搭建设备操作和监控画面。拖拽画面从工具箱取控件;代码画面使用同名自定义元素。运行时由 window.darra 绑定,不要直接操作 WebSocket。
工具箱按西门子分组顺序网格排列,只显示已接入设计器的控件。选择控件时以当前 IDE 工具箱和属性面板为准。绑定字段合同以设计器注册表为准;未注册控件只提供通用 value 字段。
工具箱分类
| 分类 | 类别 | 读写 | 当前可用控件示例 |
|---|---|---|---|
| 基本对象 | 显示 | 只读 | 标签、图片、矩形、圆形、直线、箭头、椭圆、折线、多边形 |
| 输入与按钮 | 操作 | 读写 | 按钮、自复位按钮、输入框、下拉框 |
| 显示与指示 | 显示 | 只读 | 进度条、指示灯、圆形仪表、温度计、图片切换、时钟、状态显示、图形列表、信号塔灯、走马灯 |
| 开关与调节 | 操作 | 读写 | 复选框、拨动开关、滑块、旋钮、选择开关 |
| 容器布局 | 布局 | 设计读写 | 面板、分组框、标签页、分隔线 |
| 工业图元 | 显示 | 只读 | 液位罐、管道、阀门、电机、泵、压缩机、过滤器、换热器、弯头、三通 |
| 报警 | 报警 | 读 + 确认 | 报警横幅、报警列表、报警汇总 |
| 趋势图表 | 显示 | 只读 | 趋势、折线、柱状、饼图、仪表、K 线、桑基、热力、树图、雷达、液体球、环形仪表和 3D 绘图 |
| 表格数据 | 显示 | 只读 | 表格、日程、参数表单、键值表、步序查看、甘特显示、程序列表和统计卡 |
| 系统诊断 | 诊断 | 只读 | 数据记录器、设备列表、错误控制台和系统健康 |
| 系统状态 | 诊断 | 只读 | OPC UA 状态、HSL 设备状态、EtherCAT 状态和通用连接卡 |
| 用户权限 | 安全 | 读写(受控) | 登录、用户标识、权限门控、用户管理、审计、会话和角色权限 |
| 报表与设备配方 | 配方 | 读写(受控) | 报表预览、设备配方控件 |
| 导航与媒体 | 媒体 | 只读 | 富文本、媒体、PDF、二维码、内嵌网页和地图 |
| 视觉 | 视觉 | 只读 | 相机图像 |
登录走 WebView2,不要自建凭证页。视觉控件只显示异步作业结果,不在扫描周期内等待相机或推理。
通用属性
所有 <darra-*> 控件共享下列属性。运行时由 window.darra 读取 data-* 并应用。
| 属性 | 类别 | 读写 | 类型 | 说明 |
|---|---|---|---|---|
代码名 data-darra-name | 标识 | 设计读写 / 运行只读 | 字符串 | 页内唯一;darra.ctl(name) 按名取元素 |
| 绑定变量 | 数据 | 读写(按控件) | 符号 | 主字段绑定的项目变量 |
| 文本 | 显示 | 读写 | 字符串 | 标题或显示文本 |
可见 data-visible | 显示 | 读写 | BOOL | false 时 display:none |
使能 data-enabled | 交互 | 读写 | BOOL | false 时灰显并禁止交互,仍显示当前值 |
只读 data-readonly | 交互 | 读写 | BOOL | 保留显示,禁止写入 |
所需权限 data-darra-permission | 安全 | 读写 | 级别 | 当前用户级别不足则强制只读 |
| X、Y、宽度、高度 | 几何 | 读写 | 数值 | 相对画布的百分比位置 |
| 层级 | 图层 | 读写 | 整数 | 前后顺序 |
| 锁定 | 设计期 | 读写 | BOOL | 仅限制设计期移动 |
权限级别:0 匿名、1 viewer、2 operator、3 admin。未登录按 0,工业默认拒绝写入。
已注册绑定字段
下列控件在数据绑定向导中有字段表。字段名写入 data-darra-bind-<FieldName>;主字段 value 可简写为 data-darra-bind。
显示控件
| 控件 | 字段 | 类别 | 读写 | 类型 | 说明 |
|---|---|---|---|---|---|
| Gauge | value | 显示 | 只读 | NUM | 仪表指针值,必填 |
| Gauge | min | 量程 | 只读 | NUM | 刻度下限 |
| Gauge | max | 量程 | 只读 | NUM | 刻度上限 |
| Gauge | unit | 显示 | 只读 | STRING | 工程单位 |
| Lamp | state | 显示 | 只读 | BOOL | ON / OFF,必填 |
| Lamp | color | 显示 | 只读 | STRING | 颜色名或十六进制 |
| Tank | level | 显示 | 只读 | NUM | 当前液位,必填 |
| Tank | min | 量程 | 只读 | NUM | 液位下限 |
| Tank | max | 量程 | 只读 | NUM | 液位上限 |
| Tank | color | 显示 | 只读 | STRING | 液体颜色 |
| ProgressBar | progress | 显示 | 只读 | NUM | 0–100 百分比,必填 |
| NumericDisplay | value | 显示 | 只读 | NUM | 显示数值,必填 |
| NumericDisplay | decimals | 格式 | 只读 | NUM | 小数位数 |
| BoolIndicator | state | 显示 | 只读 | BOOL | TRUE / FALSE,必填 |
| LineTrendChart | value | 显示 | 只读 | NUM | 实时采样,必填 |
| LineTrendChart | sampleCount | 显示 | 只读 | NUM | X 轴最大点数,默认 100 |
| DataGrid | dataSource | 显示 | 只读 | ANY | DB 数组或 Tag 表,必填 |
| Label | text | 显示 | 只读 | STRING | 显示文本 |
| ImageDisplay | src | 显示 | 只读 | STRING | 图片 URL 或资源路径 |
| ImageDisplay | visible | 显示 | 只读 | BOOL | TRUE 显示 |
| AlarmList | filter | 报警 | 只读 | STRING | 类别 / 优先级筛选 |
写控件
| 控件 | 字段 | 类别 | 读写 | 类型 | 说明 |
|---|---|---|---|---|---|
| PushButton | trigger | 操作 | 只写请求 | BOOL | 按下写入目标,必填 |
| ToggleSwitch | state | 操作 | 读写 | BOOL | ON / OFF 双向,必填 |
| RotaryKnob | value | 操作 | 读写 | NUM | 旋钮当前值,必填 |
| RotaryKnob | min | 量程 | 只读 | NUM | 下限 |
| RotaryKnob | max | 量程 | 只读 | NUM | 上限 |
| Slider | value | 操作 | 读写 | NUM | 滑块当前值,必填 |
| Slider | min | 量程 | 只读 | NUM | 下限 |
| Slider | max | 量程 | 只读 | NUM | 上限 |
未注册控件兜底字段:value(类别:通用,读写:按控件,类型:ANY)。
按钮参数
| 参数 | 类别 | 读写 | 可选值 | 说明 |
|---|---|---|---|---|
| 动作 | 操作 | 读写 | momentary、set、reset、toggle、print | 默认 momentary |
| 按下值 | 操作 | 读写 | 默认 1 | 按下写入 |
| 松开值 | 操作 | 读写 | 默认 0 | 松开写回 |
| 形状 | 外观 | 读写 | 圆角、直角、胶囊、圆形 | 视觉 |
| 操作前确认 | 安全 | 读写 | 关 / 开 | 可配置确认文案 |
| 点击跳转 | 导航 | 写 | 目标页面路由 | 与写入动作分开配置 |
自复位按钮按下写按下值,松开、移出或抬指写回松开值。设备启停应绑定请求变量,由 PLC SCL 处理联锁。
输入框参数
| 参数 | 类别 | 读写 | 说明 |
|---|---|---|---|
| 类型 | 输入 | 读写 | 数字或文本,默认数字 |
| 最小值 / 最大值 / 步进 | 量程 | 读写 | 数字输入约束 |
| 单位 | 显示 | 读写 | 输入框旁工程单位 |
| 确认写入 | 安全 | 读写 | 默认关闭,可配置确认文案 |
输入框在回车或失焦时提交,编辑期间不被远端刷新打断。可写性仍受权限和白名单限制。
指示灯参数
| 参数 | 类别 | 读写 | 默认值 |
|---|---|---|---|
| 真值颜色 | 外观 | 读写 | #00E676 |
| 假值颜色 | 外观 | 读写 | #4A4A55 |
| 形状 | 外观 | 读写 | 圆形,可改方形 |
| 闪烁 | 外观 | 读写 | 不闪、常闪、真值闪、假值闪 |
| 闪烁周期 | 外观 | 读写 | 500 ms |
状态显示
状态显示把离散值映射为文本和颜色,来源必须是 PLC 变量:
0:停止:#5A6573,1:运行:#2E9B5B,2:故障:#D64545
HMI 不自行推进设备状态。
代码画面自定义元素
| 元素 | 类别 | 读写 | 主属性 | 说明 |
|---|---|---|---|---|
<darra-button> | 操作 | 写请求 | var、action、on-value、off-value | 按钮 |
<darra-led> | 显示 | 只读 | var、color-on、color-off | 指示灯 |
<darra-numeric> | 显示 | 只读 | var | 数字显示 |
<darra-label> | 显示 | 只读 | var、unit | 标签 |
<darra-input> | 操作 | 读写 | var、type、min、max、step | 输入框 |
<darra-gauge> | 显示 | 只读 | var | 仪表 |
<darra-trend> | 显示 | 只读 | vars | 趋势 |
<darra-alarm-list> | 报警 | 读 + 确认 | — | 报警列表 |
<darra-image-toggle> | 显示 | 只读 | var | 图片切换 |
优先用声明式 var= 绑定,减少手写订阅。
选择建议
- 只显示一个值:标签、指示灯、仪表或统计卡。
- 调整一个设定值:输入框、滑块或旋钮。
- 选择有限模式:下拉框或选择开关。
- 显示多状态:状态显示或图形列表。
- 显示连续历史:趋势控件。
- 显示记录集合:表格。
- 显示设备过程:工业图元配合状态和动画绑定。