Mingcedar

所属产品: Mingcedar Studio DESIGNER

文本行为：内容显示该用哪一种 | Mingcedar Studio

Script Text 用表达式生成文本，Tag Text 显示单个 Tag，Localized Text 按语言键显示固定文案。

首次发布 最近更新

<section id="text-behaviors" class="docs-block docs-block-intro docs-block-current"> <span class="section-kicker">文本</span> <h2>文本行为：内容显示该用哪一种</h2> <p>Script Text 用表达式生成文本，Tag Text 显示单个 Tag，Localized Text 按语言键显示固定文案。</p> <div class="docs-detail-list"> <article id="text-behaviors-item-1" class="docs-detail-row"> <strong>Script Text：通过表达式生成显示文本</strong> <p>需要拼接数值、格式化数字或按条件选择文案时，使用 Script Text。将下例的变量声明放入 Setup Script，文本表达式放入 Display Text；Condition 填 true 时持续更新显示，也可填写控制更新的布尔条件。</p> <ul> <li>适合格式化和拼接</li><li>适合带单位和条件文案</li><li>适合多个数据源组合成一句话</li> </ul> <pre class="docs-code-block"><code>var pressure = ReadTagDouble(&quot;PLC_LINE01.PUMP01.PRESSURE&quot;, 0.0);

&quot;Pressure: &quot; + pressure.toFixed(1) + &quot; bar&quot;</code></pre> </article><article id="text-behaviors-item-2" class="docs-detail-row"> <strong>Tag Text：一个 Tag 直接显示成文本</strong> <p>Tag Text 用于显示单个 Tag 并附加前缀或单位。Target tag 可直接填完整名称、带占位符的名称或名称字符串变量；对象属性使用 =bindingConfig.temperatureTag。Fallback value、Prefix 和 Suffix 是字符串表达式，固定文字或其中的占位符应写在引号内。</p> <ul> <li>适合直接显示一个 Tag</li><li>适合配 Prefix / Suffix</li><li>简单场景优先于 Script Text</li> </ul> <pre class="docs-code-block"><code>Target tag: &#39;&lt;PLC&gt;.TEMP&#39;

Fallback value: &#39;&lt;DEFAULT_TEXT&gt;&#39;

Prefix: &#39;&lt;TITLE&gt;&#39;

Suffix: &quot; °C&quot;</code></pre> </article><article id="text-behaviors-item-3" class="docs-detail-row"> <strong>Localized Text：文本不是值，而是语言键</strong> <p>当一个文本对象显示的是语言键对应的翻译，而不是实时数值时，用 Localized Text。按钮标题、面板标题、菜单项、固定状态词最适合这种方式。</p> </article><article id="text-behaviors-item-4" class="docs-detail-row"> <strong>模板参数在文本字段中的写法</strong> <p>模板实例先替换占位符，再按各字段规则使用结果。Target tag 可直接填 &lt;PLC&gt;.OVEN01.TEMPERATURE；Prefix、Fallback value 等字符串表达式填写 &quot;&lt;TITLE&gt;&quot;、&quot;&lt;DEFAULT_TEXT&gt;&quot;。需要运行时计算名称时，在目标字段使用 = 表达式；在 JavaScript 方法参数中直接使用名称变量。</p> </article><article id="text-behaviors-item-5" class="docs-detail-row"> <strong>Tag Text 的模板变量写法</strong> <p>Tag Text 的 Target tag 可直接填 &lt;PLC&gt;.TEMP；Fallback value、Prefix、Suffix 中的模板参数应写在字符串内，例如 `&#39;&lt;DEFAULT_TEXT&gt;&#39;`、`&#39;&lt;TITLE&gt;&#39;`。在 JavaScript 读取方法中使用带占位符的 Tag 名称时，也应加引号。</p> </article><article id="text-behaviors-item-6" class="docs-detail-row"> <strong>Script Text 的返回值要求</strong> <p>Script Text 的 Display Text 返回最终显示字符串。Setup Script 可读取多个 Tag 并准备中间值；Condition 决定是否更新文本。需要多语言时，固定文案优先使用 Localized Text，实时数值部分由脚本组合。</p> </article> </div> <div class="docs-note-grid"> <figure id="text-behaviors-image-1" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/TextBehaviorEditorForm.png" alt="Script Text" loading="lazy" decoding="async"> <figcaption> <strong>Script Text</strong> <p>文本需要拼接、格式化或组合多个值时，Script Text 更合适。</p> </figcaption> </figure><figure id="text-behaviors-image-2" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/TextBehaviorEditorFormTagText.png" alt="Tag Text" loading="lazy" decoding="async"> <figcaption> <strong>Tag Text</strong> <p>一个 Tag 直接显示成文本时，Tag Text 会比写脚本更简单。</p> </figcaption> </figure><figure id="text-behaviors-image-3" class="docs-note-card manual-doc-image-card"> <img src="/WEB_img/HQPPT/LanguageSettingsForm.png" alt="Localized Text" loading="lazy" decoding="async"> <figcaption> <strong>Localized Text</strong> <p>固定文案和语言键显示，优先使用 Localized Text。</p> </figcaption> </figure> </div> </section>