文档手册

Template Edit：插入后如何调整实例配置 | HQ VISU Designer

Template Edit 负责的是“当前这一个模板实例”。模板插入后，真正落地到当前页面上的就是实例，而不是模板源本身。

模板方法实例

实例

Template Edit：插入后如何调整实例配置

Template Edit 负责的是“当前这一个模板实例”。模板插入后，真正落地到当前页面上的就是实例，而不是模板源本身。

所有模板实例都支持什么

当前所有模板实例都支持 X、Y、Width、Height。也就是说，不论模板内容是什么，至少都能通过模板编辑器控制它在页面上的位置和占位范围。

模板实例和模板源的关系

模板源决定模板的原始结构、输入项和默认内容；模板实例决定当前页面中的摆放方式、配置内容，以及具体连接的变量或 Tag。模板源提供可复用结构，模板实例提供当前页面的落地参数。

模板变量填写方法

模板变量在配置字段中按 JavaScript 字符串书写。需要使用 `<PLC>`、`<MUBAN>`、`<TITLE>` 这类模板变量时，应写成 `'<PLC>'` 或 `"<PLC>"`；组合点名同样写成 `'<PLC>.<TAG>'` 或 `"<PLC>.<TAG>"`。单引号和双引号都支持，未加引号的 `<PLC>` 不属于支持写法。

推荐：'<PLC>' 或 "<PLC>"
组合点名：'<PLC>.<TAG>' 或 "<PLC>.<TAG>"
不支持：<PLC>、<PLC>.<TAG>
导出替换后仍保持合法字符串，例如 '<PLC>' -> 'DK'

实例尺寸与模板源的调整边界

如果只是当前页这一个实例位置不同、尺寸不同，就改实例；如果是所有同类模板结构都要变，例如多一列、多一个按钮、字段布局整体改变，就该回模板源调整。

推荐配置顺序

先插入模板，再打开 Template Edit，依次调整 X、Y、Width、Height 和实例级配置。确认实例配置完整后，再继续连接脚本或 Tag。

实例变量维护顺序

建议先维护影响范围最大的变量，例如 PLC、设备编码、DB、画面标题，再维护单个对象的 Tag、文本和单位。这样可以先建立实例的主要数据边界，再处理细节字段。

变量替换范围

模板变量只替换当前模板实例中声明的占位内容，不会自动改写页面上所有同名文本。需要跨页面或跨多个实例整理变量时，应使用 Batch Replace，并在替换前确认作用范围。