跳到主要内容

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显示读写BOOLfalse 时 display:none
使能 data-enabled交互读写BOOLfalse 时灰显并禁止交互,仍显示当前值
只读 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。

显示控件​

控件字段类别读写类型说明
Gaugevalue显示只读NUM仪表指针值,必填
Gaugemin量程只读NUM刻度下限
Gaugemax量程只读NUM刻度上限
Gaugeunit显示只读STRING工程单位
Lampstate显示只读BOOLON / OFF,必填
Lampcolor显示只读STRING颜色名或十六进制
Tanklevel显示只读NUM当前液位,必填
Tankmin量程只读NUM液位下限
Tankmax量程只读NUM液位上限
Tankcolor显示只读STRING液体颜色
ProgressBarprogress显示只读NUM0–100 百分比,必填
NumericDisplayvalue显示只读NUM显示数值,必填
NumericDisplaydecimals格式只读NUM小数位数
BoolIndicatorstate显示只读BOOLTRUE / FALSE,必填
LineTrendChartvalue显示只读NUM实时采样,必填
LineTrendChartsampleCount显示只读NUMX 轴最大点数,默认 100
DataGriddataSource显示只读ANYDB 数组或 Tag 表,必填
Labeltext显示只读STRING显示文本
ImageDisplaysrc显示只读STRING图片 URL 或资源路径
ImageDisplayvisible显示只读BOOLTRUE 显示
AlarmListfilter报警只读STRING类别 / 优先级筛选

写控件​

控件字段类别读写类型说明
PushButtontrigger操作只写请求BOOL按下写入目标,必填
ToggleSwitchstate操作读写BOOLON / OFF 双向,必填
RotaryKnobvalue操作读写NUM旋钮当前值,必填
RotaryKnobmin量程只读NUM下限
RotaryKnobmax量程只读NUM上限
Slidervalue操作读写NUM滑块当前值,必填
Slidermin量程只读NUM下限
Slidermax量程只读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= 绑定,减少手写订阅。

选择建议​

  • 只显示一个值:标签、指示灯、仪表或统计卡。
  • 调整一个设定值:输入框、滑块或旋钮。
  • 选择有限模式:下拉框或选择开关。
  • 显示多状态:状态显示或图形列表。
  • 显示连续历史:趋势控件。
  • 显示记录集合:表格。
  • 显示设备过程:工业图元配合状态和动画绑定。

相关文档​