Tag Text 标签文本

功能说明

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

字段配置

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

• Target tag：可直接填完整 Tag 名称 PLC_LINE01.OVEN01.TEMPERATURE，也支持带引号的名称、地址字符串变量和 =bindingConfig.temperatureTag。目标应为名称字符串，无需调用读取方法。
• Fallback value（默认值）：标签读不到值时显示的默认文本，默认是空字符串。
• Prefix（前缀）：拼在值前面的文字，例如 "Temperature: "。
• Suffix（后缀）：拼在值后面的文字，例如 " °C"。
• Use quality outline colors：启用质量边框。通信质量正常时使用 Good 颜色（默认 #000000），异常时使用 Bad 颜色（默认 #FF8800）。

Target tag: PLC_LINE01.OVEN01.TEMPERATURE
Fallback value:  "--"
Prefix:         "温度："
Suffix:         " °C"
// 显示示例：温度：36.5 °C

适用场景

用于直接显示单个 Tag，例如：

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

限制与常见问题

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