HMI 主题
设计页面时用主题统一颜色、背景和图表色板。主题随 .dplc 项目保存,发布后由本地 HMI 和 WebHMI 共同使用。
设计期色板
项目主题提供 7 个静态预设,权威字段对应 darra-hmi.css 的 --hmi-* 变量。默认是工业浅色。
| 预设 | 适用场景 |
|---|---|
| 工业浅色 | 默认,低饱和灰底,适合明亮现场 |
| 工业深色 | 弱光车间和大屏 |
| 高对比 | 强光环境和无障碍场景 |
| 蓝白 | 明亮设备面板 |
| Office 蓝 | 办公监控页面 |
| 石墨 | 低饱和中性暗色 |
| 暖工业 | 暖灰和琥珀强调色 |
工程师还可以调整背景、面板、强调色、文本、正常、警告、错误、信息、边框、网格线和图表色板。设计器里可能还有更多编辑期皮肤样例;它们用于生成项目色板,不是运行时 setTheme() 参数。
背景模式
| 模式 | 可调参数 |
|---|---|
| 纯色 | 主背景色 |
| 渐变 | 两个颜色、线性或径向、角度 0–360° |
| 图片 | 图片地址;铺满、完整、平铺或拉伸 |
背景图片应随项目发布并控制体积。现场页面优先使用低对比纹理,不要用持续播放的背景动画。
运行时切换
公开运行时 API 只接受两个皮肤名:
modern:工业深色运行皮肤industrial:工业浅色运行皮肤
darra.setTheme('industrial');
console.log(darra.getTheme());
其它名字会回落到 modern。需要品牌色时,在设计器中改项目色板并重新发布,不要把七个预设名传给 setTheme()。
主题变化会触发 themeChanged。图表应在该事件后刷新。
使用规则
- 正常状态尽量使用中性色,颜色主要用于异常和操作反馈。
- 文本与背景保持足够对比度;不要只用颜色表达报警状态。
- 红色仅用于错误、严重报警和危险动作,不作为黑底正文色。
- 触摸屏按钮保持足够尺寸和按下反馈。
- 图表、报警、按钮和输入控件使用同一项目色板。
- 页面始终显示 Profile 和资源真伪,不要为了“更专业”而隐藏。
排错
| 现象 | 处理 |
|---|---|
| 预览已变、现场未变 | 保存项目并重新发布 |
| 运行时切换后回到原主题 | 检查是否传入 modern 或 industrial |
| 自定义色不生效 | 检查项目主题是否被页面样式覆盖 |
| 图表颜色未更新 | 让图表在 themeChanged 后刷新 |
| 背景图片不显示 | 确认图片已纳入发布资源 |