Click Script / Hover Script：适合局部特化动作，不替代标准行为 | HQ VISU Designer

局部动画、状态提示、自定义校验、复杂流程跳转、输入确认后二次处理，这些场景适合 Click Script。当一个动作不只是写一个值或跳转一个页面时，可以通过脚本组织组合逻辑。

Click Script 适合先读页面输入、再判断条件、再调用标准方法。脚本中仍应优先调用 qtedit.openPage、qtedit.openDiagnosis、qtedit.writeTag 等明确方法，而不是把全部逻辑写成不可复用的 DOM 操作。

• 读取输入模板：template.getValue("Input Template")
• 确认条件：if (...) return;
• 写值：qtedit.writeTag(payload)
• 跳转：qtedit.openPage("Alarm")

var value = template.getValue("SetpointInput");
if (value === "") {
  qtedit.setComponentText("Message", "请输入设定值");
  return;
}

qtedit.writeTag({
  TagName: "Device.SETPOINT",
  Value: Number(value),
  PermissionCode: "io:write",
  RequireConfirm: true
});

悬停高亮、预览、局部透明度变化、帮助提示和短时反馈都适合 Hover Script。它最好的用法是做轻量反馈，而不是承载重业务逻辑。

// Mouse Over
object.style.opacity = "0.7";

// Mouse Out
object.style.opacity = "1";

当目标需要动态计算、需要先校验输入、需要组合多个方法、或者需要在一次点击里顺序执行多个动作时，脚本通常更合适。比如先读模板值，再判断是否合法，再写 Tag，再切换页面。

如果只是打开页面、写一个 Tag、打开诊断窗或切换一个页面变量，应优先使用明确配置行为。这样维护人员可以直接从界面理解动作意图，不需要先阅读脚本逻辑。