跳至主要内容

Range Color 范围颜色

将连续数值映射到颜色区间,并为各区间配置填充、边框和可见性。默认配置为五个区间,可按需新增或删除,支持 1–24 个区间。

颜色文档修订:2026-10-21

颜色: Range Color 范围颜色

将连续数值映射到颜色区间,并为各区间配置填充、边框和可见性。默认配置为五个区间,可按需新增或删除,支持 1–24 个区间。

功能说明

Range Color 用于温度、压力、液位或负载等连续数值的分段显示。默认四个上限形成五个区间;通过 + Add range 新增区间或删除现有行,可调整为 1–24 个区间。数值上限按递增顺序填写,每个区间设置独立的显示状态。

字段配置

Setup script 准备数据,Range value 返回数值;Range actions 中每行代表一个区间,最后一行为 Final (+∞)。以下代码分别填写到标注字段。

  • Behavior name 可编辑,Component name 只读。
  • Setup Script:可选,供当前行为准备数值。
  • Range value:数值表达式,不填写 Tag 名称字符串或颜色字符串。
  • Upper limit:除最终区间外,按递增顺序填写有限数值。
  • Fill / Border / Visibility:启用所需通道并逐行配置。
  • + Add range 新增区间;删除行后应重新检查相邻边界。
  • Quality override:Follow data quality (border / hide) 配置 Good / Bad 与质量异常时隐藏;显式区间边框优先于 Good。
  • Save 校验脚本和数值上限;空白、非数字、非有限或非递增上限会阻止保存。
JavaScriptJavaScript
// Setup script
var temperature = ReadTagDouble("PLC_LINE01.OVEN01.TEMPERATURE", 0);

// Range value
temperature

// Upper limit: 60, 80, 95, 110
// Final (+∞): values above 110

适用场景

用于按颜色区分连续数值的档位,例如:

  • 温度分段示例:≤60、(60,80]、(80,95]、(95,110]、>110;每段按工艺规范配置颜色。
  • 负载分段:按低、正常、偏高和超限区间显示,区间颜色本身不会创建宿主报警事件。

限制与常见问题

区间边界与发布验证:

  • 四个上限 L1 < L2 < L3 < L4 对应五段:值 ≤ L1、L1 < 值 ≤ L2、L2 < 值 ≤ L3、L3 < 值 ≤ L4、值 > L4。
  • 上限属于它所在的区间;这与 Discrete Color 的 Value < 严格小于规则不同。
  • N 个区间对应 N−1 个递增上限;仅一个区间时不设置上限,所有有效数值使用该区间。
  • 使用旧版运行时的项目应在更新插件与宿主后重新导出并发布。每次增删区间后,验证各上限及最终区间的填充、边框和可见性。
  • 保存前逐行检查有限数值、递增顺序和显示通道;错误值不会自动作为 0 保存。
  • 质量覆盖处理数据可信度;工艺报警需要在宿主中独立配置。
Range Color 范围颜色编辑器
图示 1: Range Color 编辑器

用 4 个阈值把数值分成 5 段,每段配一种填充/边框颜色或显隐。

再次点击图片或按 Esc 关闭