Tag Text 标签文本

功能说明

Tag Text（标签文本，行为目录 Text 分类下，旧名 IO Read）是把单个标签的值直接显示成文本的行为。它是 Script Text（脚本文本）的简化版：当只需要把一个标签原样显示出来、不需要任何拼接或计算逻辑时，用它最简化操作，全程不用写脚本。给一个文本框或形状绑定 Tag Text 后，运行时会读取指定标签，套上前缀和后缀显示出来，例如把温度标签显示成 “Temperature: 36.5 °C”。

使用方法：编辑器里要填的字段

双击组件下的 Tag Text 行为节点打开编辑器，按下面几个字段填写即可：

• Tag Expression（标签表达式）：要显示的标签，写成带引号的字符串表达式，例如 "Device.TAGNAME"，默认值就是 "Device.TAGNAME"。
• Default Value（默认值）：标签读不到值时显示的兜底文本，默认是空字符串。
• Prefix（前缀）：拼在值前面的文字，例如 "Temperature: "。
• Suffix（后缀）：拼在值后面的文字，例如 " °C"。
• Quality Border（质量边框）：可选开关。开启后，通讯质量好时边框用 GOOD 颜色（默认 #000000），质量坏时用 BAD 颜色（默认 #FF8800）。

Tag Expression: "Device.TAGNAME"
Default Value:   ""
Prefix:          "Temperature: "
Suffix:          " °C"
// 运行时显示： Temperature: 36.5 °C

适用场景

适合“一个标签原样显示成文本”的场景，不需要任何判断或计算：

• 把一个测量值（温度、压力、液位、流量）配上单位直接显示在画面上。
• 显示设备的运行模式名、批次号等字符串标签。
• 如果显示文本需要多个标签、条件判断或格式化计算，请改用 Script Text（脚本文本）。

边界与易错点

Tag Expression、Default Value、Prefix、Suffix 都是 JavaScript 表达式，不是纯文本框。所以标签和文字都要带引号：标签写 "Device.TAGNAME"，前缀写 "Temperature: "。如果漏写引号、直接填裸标签路径（如 Device.TAGNAME），会被当成表达式求值而显示不出来。另外 Quality Border 反映的是通讯质量（good / bad），不是工艺值本身，也不是报警状态。