跳至主要内容

Script Text 脚本文本

Script Text 根据表达式显示动态文本,适用于单位、小数位、条件文字及多个数值的组合。

文本文档修订:2026-10-21

文本: Script Text 脚本文本

Script Text 根据表达式显示动态文本,适用于单位、小数位、条件文字及多个数值的组合。

功能说明

Script Text 位于 Behaviors → Text。将它绑定到文本框或支持文本的形状后,Display Text 表达式决定显示内容。仅显示单个 Tag 时可使用 Tag Text。

字段配置

Setup Script 准备当前行为使用的数据,Display Text 返回显示字符串,Condition 控制是否执行。以下示例按注释分别填写;不需要准备代码时,应清空 Setup Script 的默认内容。

  • Setup Script:准备区。读标签、定义变量、做中间计算(可多行)。
  • Display Text:返回要显示的字符串。
  • Condition:返回 true 时应用文本;返回 false 时不执行本行为。
  • Use quality outline colors:按通信质量应用 Good 或 Bad 边框色;质量边框不表示工艺值或报警状态。
JavaScriptJavaScript
// Setup Script
var pressure = ReadTagDouble("PLC_LINE01.AIR01.PRESSURE", 0.0);

// Display Text
"压力:" + pressure.toFixed(1) + " bar"

适用场景

用于格式化或组合动态信息。

  • 显示带单位、带固定小数位的测量值,如“压力:3.2 bar”。
  • 把多个标签合成一句话,如“泵1 运行 / 转速 1450 rpm”。
  • 按条件输出不同文字,如运行时显示“运行中”、停机时显示“已停止”。

常见问题

Display Text 只接受返回单个值的表达式,不能填写完整脚本。

  • 不要在 Display Text 中放 fetch、setTimeout 这类异步代码,它需要立即得到一个值;这类逻辑放到 Page Script/Click Script 等脚本体里。
  • 复杂的读取与计算放在 Setup Script,Display Text 尽量只做最终拼接。
  • 读标签务必用带引号的标签名和默认值,如 ReadTagDouble("PLC_LINE01.AIR01.PRESSURE", 0.0),避免裸写标签名。
  • 质量边框只反映通信质量(good/bad),不表示工艺状态。
Script Text 脚本文本行为编辑器
图示 1: Script Text 编辑器

在 Setup Script 里读标签并计算,在 Display Text 中返回最终要显示的字符串。

再次点击图片或按 Esc 关闭