Mingcedar

所属产品: Mingcedar Studio DESIGNER

Range Color 范围颜色 | Mingcedar Studio

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

首次发布 最近更新

<div class="manual-doc-article manual-doc-article-section"><h2 id="range-color">颜色: Range Color 范围颜色</h2>

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

<div class="doc-card-list">

<article class="doc-card">

<h3 id="range-color-item-1">功能说明</h3>

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

</article>

<article class="doc-card doc-card-warn">

<h3 id="range-color-item-2">字段配置</h3>

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

<ul>

<li>Behavior name 可编辑，Component name 只读。</li>

<li>Setup Script：可选，供当前行为准备数值。</li>

<li>Range value：数值表达式，不填写 Tag 名称字符串或颜色字符串。</li>

<li>Upper limit：除最终区间外，按递增顺序填写有限数值。</li>

<li>Fill / Border / Visibility：启用所需通道并逐行配置。</li>

<li>+ Add range 新增区间；删除行后应重新检查相邻边界。</li>

<li>Quality override：Follow data quality (border / hide) 配置 Good / Bad 与质量异常时隐藏；显式区间边框优先于 Good。</li>

<li>Save 校验脚本和数值上限；空白、非数字、非有限或非递增上限会阻止保存。</li>

</ul>

<div class="manual-code" data-code-language="javascript"><div class="manual-code-toolbar"><span>JavaScript</span><span class="manual-code-tools"><small>JavaScript</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: JavaScript">复制代码</button><span class="manual-code-status" role="status"></span></span></div><pre tabindex="0" class="docs-code-block shiki github-light" style="background-color:#fff;color:#24292e" tabindex="0"><code><span class="line"><span style="color:#6A737D">// Setup script</span></span>

<span class="line"><span style="color:#D73A49">var</span><span style="color:#24292E"> temperature </span><span style="color:#D73A49">=</span><span style="color:#6F42C1"> ReadTagDouble</span><span style="color:#24292E">(</span><span style="color:#032F62">"PLC_LINE01.OVEN01.TEMPERATURE"</span><span style="color:#24292E">, </span><span style="color:#005CC5">0</span><span style="color:#24292E">);</span></span>

<span class="line"></span>

<span class="line"><span style="color:#6A737D">// Range value</span></span>

<span class="line"><span style="color:#24292E">temperature</span></span>

<span class="line"></span>

<span class="line"><span style="color:#6A737D">// Upper limit: 60, 80, 95, 110</span></span>

<span class="line"><span style="color:#6A737D">// Final (+∞): values above 110</span></span></code></pre></div>

</article>

<article class="doc-card">

<h3 id="range-color-item-3">适用场景</h3>

<p>用于按颜色区分连续数值的档位，例如：</p>

<ul>

<li>温度分段示例：≤60、(60,80]、(80,95]、(95,110]、&gt;110；每段按工艺规范配置颜色。</li>

<li>负载分段：按低、正常、偏高和超限区间显示，区间颜色本身不会创建宿主报警事件。</li>

</ul>

</article>

<article class="doc-card doc-card-warn">

<h3 id="range-color-item-4">限制与常见问题</h3>

<p>区间边界与发布验证：</p>

<ul>

<li>四个上限 L1 &lt; L2 &lt; L3 &lt; L4 对应五段：值 ≤ L1、L1 &lt; 值 ≤ L2、L2 &lt; 值 ≤ L3、L3 &lt; 值 ≤ L4、值 &gt; L4。</li>

<li>上限属于它所在的区间；这与 Discrete Color 的 Value &lt; 严格小于规则不同。</li>

<li>N 个区间对应 N−1 个递增上限；仅一个区间时不设置上限，所有有效数值使用该区间。</li>

<li>使用旧版运行时的项目应在更新插件与宿主后重新导出并发布。每次增删区间后，验证各上限及最终区间的填充、边框和可见性。</li>

<li>保存前逐行检查有限数值、递增顺序和显示通道；错误值不会自动作为 0 保存。</li>

<li>质量覆盖处理数据可信度；工艺报警需要在宿主中独立配置。</li>

</ul>

</article>

</div>

<div class="docs-note-grid manual-doc-image-grid">

<figure class="docs-note-card manual-doc-image-card" id="range-color-image-1">

<img src="/WEB_img/HQPPT/current/color/range.png" alt="Range Color 范围颜色编辑器" loading="lazy" decoding="async" />

<figcaption>

<strong>图示 1: Range Color 编辑器</strong>

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

</figcaption>

</figure>

</div>

</div>