文档手册

模板：input / keypad / table 与模板变量、批量替换

模板 = 一个 PowerPoint 组 + 模板元数据（模板名、变量列表、变量值）。它在原生“打组”之上加了一层“变量化”能力：先把一组组件画好、打成组、存成模板，之后从模板库插入，只需填 PLC、DB 这类少量变量，整组里所有动画的 Tag 地址就会自动套上对应设备。这样既保留 PPT 原生编辑体验，又把“同一个设备模板复制很多份、Tag 地址一条条手改”的成本降下来。

功能

功能: 模板：input / keypad / table 与模板变量、批量替换

用模板把一组画好的组件存成可复用资产，插入后只填 PLC、DB 等少量变量就能完成整组 Tag 绑定。内置 input / keypad / table 三种模板分别做输入框、数字键盘和动态表格；Template Edit 编辑实例，Batch Replace 批量替换文本和模板变量。

它是什么、解决什么问题

产品提供三种内置模板：input（输入框，三种绑定模式）、keypad（给输入框配数字键盘）、table（动态表格）。功能区 Templates 分组里有三个入口：Template Library（模板库）、Template Edit（编辑选中的模板实例）、Batch Replace（批量替换）。

使用方法：保存、插入与各编辑器字段

保存与插入：在 PPT 里把一组组件画好并打组，选中后到 Template Library 点 Save 存入本地模板库；之后在模板库中双击或拖拽插入，新插入的组会被标记为“模板实例”。模板库还支持 Import / Export（在不同电脑间交换模板）和 Delete。

Template Edit 编辑实例的字段（按模板类型不同）：

所有实例通用：Position and Size 区的 X / Y / Width / Height（顶部还会只读显示 Instance / Template / Group）
普通模板实例：Template Variables 区按扫描到的 <变量名> 逐行列出输入框（如 PLC、DB、RUN_TAG），填进去即对整组生效
input 模板：Input Mode（Plain Input 仅留本地输入值不自动写 / Runtime Variable 绑运行时变量 / PLC Tag 绑 PLC 标签）、Variable 或 PLC Tag（随模式切换）、Write Trigger（默认 Immediate）、Font Size
keypad 模板：Target Input（选当前页里要操作的输入模板；数字键追加字符，Back 删一位，Clear 清空，OK 通过目标输入框写出）
table 模板：Table Name、Table Text ID、Headers、Header Text IDs、Rows（Rows 可填数组、变量名或函数名）

// 表达式里写模板变量（分段式 / 整体式）
ReadTagBoolean('<PLC>.<DB>.123', false)
ReadTagBoolean('<RUN_TAG>', false)
// 实例填 PLC=aaa, DB=456 -> 运行时等价于 aaa.456.123

适用场景

两个典型场景：

1）同类设备做很多份：一台泵/阀门画好存成模板，每多一台就从模板库插一份，进 Template Edit 填这台的 PLC、DB，整组动画自动指向该设备地址，不用逐条改 Tag。

2）做带输入和键盘的操作区：插入 input 模板并设为 Runtime Variable 或 PLC Tag，再插入 keypad 模板、在 Target Input 选中这个输入框，现场用数字键盘录入并写出。需要在脚本里读输入值时用 template.getValue("输入组件名")。

Batch Replace 适合：页面复制后快速改名、成组实例内容替换、统一术语，以及替换模板变量占位。打开后顶部显示 Scope（Selected content 选区 / Current page 当前页）和 Detected Variables（识别到的 <变量名>），填 Find / Replace，下方表格按 Type / Object / Replace In / Current Text / After Replace 实时预览命中行，确认后点 Replace。

边界与易错点

常见误区：

变量名规则严格：只允许字母、数字、下划线，且必须用尖括号包起来，如 <PLC>、<RUN_TAG>；不支持横杠、点号、空格、中文（<PLC-1>、<DB.NAME>、<设备名称> 都无效）
模板变量是“实例级”配置，只挂在模板实例根组上：复制整组时变量一起带走，所有子组件共享同一组值，不要指望逐个子组件单独设
编辑/插入时允许变量留空，但导出时会校验，若仍残留未替换的 <变量名> 会报错，导出前要填全
Template Edit 只对“模板实例根组”可用：选中普通组件或普通组时按钮不可用；选错对象会发现编辑器打不开或没有变量行
keypad 必须先有输入模板：若当前页还没有 input 模板，Target Input 会提示先插入输入模板再回来配
Batch Replace 是改文本/占位的工具，不替代模板结构调整；若每次替换后还要大量手改布局，说明该回模板源把模板定型，而不是反复批量替换

HQ VISU Designer 模板库 — **图示 1: 模板库 Template Library**
把打好组的组件存成模板，再从模板库插入复用；支持导入、导出和删除。