Mingcedar

所属产品: Mingcedar Studio DESIGNER

Tag Text 标签文本 | Mingcedar Studio

直接显示单个 Tag 的值，可配置默认值、前后缀和质量边框。

首次发布 最近更新

<div class="manual-doc-article manual-doc-article-section"><h2 id="text-tag-text">文本: Tag Text 标签文本</h2>

直接显示单个 Tag 的值，可配置默认值、前后缀和质量边框。

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

<article class="doc-card">

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

<p>Tag Text 位于 Text 分类，旧名 IO Read。将其绑定到文本组件，读取单个 Tag 并添加前后缀；需要计算或格式化时使用 Script Text。</p>

</article>

<article class="doc-card">

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

<p>双击 Tag Text 行为节点，配置以下字段：</p>

<ul>

<li>Target tag：可直接填完整 Tag 名称 PLC_LINE01.OVEN01.TEMPERATURE，也支持带引号的名称、地址字符串变量和 =bindingConfig.temperatureTag。目标应为名称字符串，无需调用读取方法。</li>

<li>Fallback value（默认值）：标签读不到值时显示的默认文本，默认是空字符串。</li>

<li>Prefix（前缀）：拼在值前面的文字，例如 &quot;Temperature: &quot;。</li>

<li>Suffix（后缀）：拼在值后面的文字，例如 &quot; °C&quot;。</li>

<li>Use quality outline colors：启用质量边框。通信质量正常时使用 Good 颜色（默认 #000000），异常时使用 Bad 颜色（默认 #FF8800）。</li>

</ul>

<div class="manual-code" data-code-language="text"><div class="manual-code-toolbar"><span>Text</span><span class="manual-code-tools"><small>Text</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: Text">复制代码</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>Target tag: PLC_LINE01.OVEN01.TEMPERATURE</span></span>

<span class="line"><span>Fallback value: "--"</span></span>

<span class="line"><span>Prefix: "温度："</span></span>

<span class="line"><span>Suffix: " °C"</span></span>

<span class="line"><span>// 显示示例：温度：36.5 °C</span></span></code></pre></div>

</article>

<article class="doc-card">

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

<p>用于直接显示单个 Tag，例如：</p>

<ul>

<li>把一个测量值（温度、压力、液位、流量）配上单位直接显示在画面上。</li>

<li>显示设备的运行模式名、批次号等字符串标签。</li>

<li>如果显示文本需要多个标签、条件判断或格式化计算，请改用 Script Text（脚本文本）。</li>

</ul>

</article>

<article class="doc-card">

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

<p>Target tag 的固定完整名称无需加引号；使用对象属性时可填 =bindingConfig.temperatureTag。Fallback value、Prefix 和 Suffix 是字符串表达式，固定文字需要加引号。需要显示数值变量、格式化结果或计算 Tag 时，使用 Script Text。Quality Border 反映数据质量，不等同于设备状态或报警。</p>

</article>

</div>

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

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

<img src="/WEB_img/HQPPT/current/text/tag-text.png" alt="Tag Text 标签文本行为编辑器" loading="lazy" decoding="async" />

<figcaption>

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

<p>填标签表达式、默认值，并可加前缀后缀，把一个标签的值直接显示成文本。</p>

</figcaption>

</figure>

</div>

</div>