跳到主要内容

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 后刷新
背景图片不显示确认图片已纳入发布资源

相关文档​