跳至主要内容

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

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

状态色与文本文本文档修订:2026-10-21
文本

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

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

Script Text:通过表达式生成显示文本

需要拼接数值、格式化数字或按条件选择文案时,使用 Script Text。将下例的变量声明放入 Setup Script,文本表达式放入 Display Text;Condition 填 true 时持续更新显示,也可填写控制更新的布尔条件。

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

Tag Text 用于显示单个 Tag 并附加前缀或单位。Target tag 可直接填完整名称、带占位符的名称或名称字符串变量;对象属性使用 =bindingConfig.temperatureTag。Fallback value、Prefix 和 Suffix 是字符串表达式,固定文字或其中的占位符应写在引号内。

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

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

模板参数在文本字段中的写法

模板实例先替换占位符,再按各字段规则使用结果。Target tag 可直接填 <PLC>.OVEN01.TEMPERATURE;Prefix、Fallback value 等字符串表达式填写 "<TITLE>"、"<DEFAULT_TEXT>"。需要运行时计算名称时,在目标字段使用 = 表达式;在 JavaScript 方法参数中直接使用名称变量。

Tag Text 的模板变量写法

Tag Text 的 Target tag 可直接填 <PLC>.TEMP;Fallback value、Prefix、Suffix 中的模板参数应写在字符串内,例如 `'<DEFAULT_TEXT>'`、`'<TITLE>'`。在 JavaScript 读取方法中使用带占位符的 Tag 名称时,也应加引号。

Script Text 的返回值要求

Script Text 的 Display Text 返回最终显示字符串。Setup Script 可读取多个 Tag 并准备中间值;Condition 决定是否更新文本。需要多语言时,固定文案优先使用 Localized Text,实时数值部分由脚本组合。

Script Text
Script Text

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

Tag Text
Tag Text

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

Localized Text
Localized Text

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

再次点击图片或按 Esc 关闭