Mingcedar

所属产品: Mingcedar Studio DESIGNER

Script Text 脚本文本 | Mingcedar Studio

Script Text 根据表达式显示动态文本，适用于单位、小数位、条件文字及多个数值的组合。

首次发布 最近更新

<div class="manual-doc-article manual-doc-article-section"><h2 id="script-text">文本: Script Text 脚本文本</h2>

Script Text 根据表达式显示动态文本，适用于单位、小数位、条件文字及多个数值的组合。

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

<article class="doc-card">

<h3 id="script-text-item-1">功能说明</h3>

<p>Script Text 位于 Behaviors → Text。将它绑定到文本框或支持文本的形状后，Display Text 表达式决定显示内容。仅显示单个 Tag 时可使用 Tag Text。</p>

</article>

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

<h3 id="script-text-item-2">字段配置</h3>

<p>Setup Script 准备当前行为使用的数据，Display Text 返回显示字符串，Condition 控制是否执行。以下示例按注释分别填写；不需要准备代码时，应清空 Setup Script 的默认内容。</p>

<ul>

<li>Setup Script：准备区。读标签、定义变量、做中间计算（可多行）。</li>

<li>Display Text：返回要显示的字符串。</li>

<li>Condition：返回 true 时应用文本；返回 false 时不执行本行为。</li>

<li>Use quality outline colors：按通信质量应用 Good 或 Bad 边框色；质量边框不表示工艺值或报警状态。</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"> pressure </span><span style="color:#D73A49">=</span><span style="color:#6F42C1"> ReadTagDouble</span><span style="color:#24292E">(</span><span style="color:#032F62">"PLC_LINE01.AIR01.PRESSURE"</span><span style="color:#24292E">, </span><span style="color:#005CC5">0.0</span><span style="color:#24292E">);</span></span>

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

<span class="line"><span style="color:#6A737D">// Display Text</span></span>

<span class="line"><span style="color:#032F62">"压力："</span><span style="color:#D73A49"> +</span><span style="color:#24292E"> pressure.</span><span style="color:#6F42C1">toFixed</span><span style="color:#24292E">(</span><span style="color:#005CC5">1</span><span style="color:#24292E">) </span><span style="color:#D73A49">+</span><span style="color:#032F62"> " bar"</span></span></code></pre></div>

</article>

<article class="doc-card">

<h3 id="script-text-item-3">适用场景</h3>

<p>用于格式化或组合动态信息。</p>

<ul>

<li>显示带单位、带固定小数位的测量值，如“压力：3.2 bar”。</li>

<li>把多个标签合成一句话，如“泵1 运行 / 转速 1450 rpm”。</li>

<li>按条件输出不同文字，如运行时显示“运行中”、停机时显示“已停止”。</li>

</ul>

</article>

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

<h3 id="script-text-item-4">常见问题</h3>

<p>Display Text 只接受返回单个值的表达式，不能填写完整脚本。</p>

<ul>

<li>不要在 Display Text 中放 fetch、setTimeout 这类异步代码，它需要立即得到一个值；这类逻辑放到 Page Script/Click Script 等脚本体里。</li>

<li>复杂的读取与计算放在 Setup Script，Display Text 尽量只做最终拼接。</li>

<li>读标签务必用带引号的标签名和默认值，如 ReadTagDouble(&quot;PLC_LINE01.AIR01.PRESSURE&quot;, 0.0)，避免裸写标签名。</li>

<li>质量边框只反映通信质量（good/bad），不表示工艺状态。</li>

</ul>

</article>

</div>

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

<figure class="docs-note-card manual-doc-image-card" id="script-text-image-1">

<img src="/WEB_img/HQPPT/current/text/script-text.png" alt="Script Text 脚本文本行为编辑器" loading="lazy" decoding="async" />

<figcaption>

<strong>图示 1: Script Text 编辑器</strong>

<p>在 Setup Script 里读标签并计算，在 Display Text 中返回最终要显示的字符串。</p>

</figcaption>

</figure>

</div>

</div>