文本行为:内容显示该用哪一种 | HQ VISU Designer

文本行为主要分三类:Script Text、Tag Text、Localized Text。区分这三类后,文本显示逻辑会清楚很多。

状态色与文本文本
文本

文本行为:内容显示该用哪一种

文本行为主要分三类:Script Text、Tag Text、Localized Text。区分这三类后,文本显示逻辑会清楚很多。

Script Text:文本内容由脚本拼出来

当文本需要拼接多个值、格式化数字、按条件选择不同文案时,用 Script Text 最合适。它的关键是 Definition 里准备数据,Text 字段里只返回最终显示字符串。

  • 适合格式化和拼接
  • 适合带单位和条件文案
  • 适合多个数据源组合成一句话
var pressure = ReadTagDouble("Device.PRESSURE", 0.0);
"Pressure: " + pressure.toFixed(1) + " bar"
Tag Text:一个 Tag 直接显示成文本

如果文本内容本质上就是一个 Tag,再加少量前后缀,例如温度、压力、模式名、当前批次号,优先使用 Tag Text。Tag、Default、Prefix、Suffix 都可以使用模板变量;包含模板变量时按字符串写法填写,例如 Tag 填 `'<PLC>.TEMP'`,Prefix 填 `'<TITLE>'`。

  • 适合直接显示一个 Tag
  • 适合配 Prefix / Suffix
  • 简单场景优先于 Script Text
Tag: '<PLC>.TEMP'
Default Value: '<DEFAULT_TEXT>'
Prefix: '<TITLE>'
Suffix: " °C"
Localized Text:文本不是值,而是语言键

当一个文本对象显示的是语言键对应的翻译,而不是实时数值时,用 Localized Text。按钮标题、面板标题、菜单项、固定状态词最适合这种方式。

文本行为的选型顺序

如果只是一个 Tag 直接显示,先用 Tag Text;如果是多语言固定文案,先用 Localized Text;如果需要组合、格式化或复杂表达,再用 Script Text。这个顺序会让页面更容易维护。

Tag Text 的模板变量写法

Tag Text 的 Tag、Default、Prefix、Suffix 可以接收模板变量。模板变量参与脚本或字符串表达式时应写入引号,例如 `'<PLC>.TEMP'`、`'<TITLE>'`、`'<DEFAULT_TEXT>'`。固定点名不需要模板变量时,可直接填写完整点名。

Script Text 的返回值要求

Script Text 的最终 Text 字段应返回字符串。Definition 可先读取多个 Tag、处理数字格式和状态判断,Text 字段只负责返回最终显示文本。需要多语言时,固定文案优先使用 Localized Text,实时数值部分再由脚本组合。

Script Text
Script Text

文本需要拼接、格式化或组合多个值时,Script Text 更合适。

Tag Text
Tag Text

一个 Tag 直接显示成文本时,Tag Text 会比写脚本更简单。

Localized Text
Localized Text

固定文案和语言键显示,优先使用 Localized Text。