文档手册

Hover Script 悬停脚本

在 Pointer Enter / Pointer Leave 时执行脚本，实现高亮和提示。仅在运行页的真实鼠标交互中触发。

交互文档修订：2026-10-21

交互: Hover Script 悬停脚本

在 Pointer Enter / Pointer Leave 时执行脚本，实现高亮和提示。仅在运行页的真实鼠标交互中触发。

Hover Script 为组件提供鼠标移入和移出两段脚本，可用于高亮或临时提示。它只在 Mingcedar 运行画面的鼠标交互中执行。移入脚本改变的外观需在移出脚本中恢复。

Trigger 固定为 Pointer Move。两个脚本框支持多行逻辑、ReadTag*、setTimeout 和 fetch 等异步调用；悬停脚本不得写入设备：

Pointer Enter（鼠标移入，文档中也称 Mouse Over）：鼠标进入图形时执行的脚本。
Pointer Leave（鼠标移出，文档中也称 Mouse Out）：鼠标离开图形时执行的脚本，用来还原移入时所做的改动。
脚本里可用的上下文对象：object、objects、event（鼠标相关）以及 tag、page、presentation、shape、hqVisuDesigner 和 globals。
object 指当前图形的 DOM 元素，可直接改它的样式（如 object.style.opacity）；shape.name 是图形名称。
注意：悬停脚本没有 Enable/Condition 启用门（这点和 Click Script 不同），两段脚本会直接执行。

// Pointer Enter（鼠标移入）
object.style.opacity = "0.7";

// Pointer Leave（鼠标移出）
object.style.opacity = "1";

用于无需点击的高亮和提示。

运行与还原要求：

移入做的修改不会自动撤销：必须在 Pointer Leave 里写对应的还原逻辑，否则鼠标离开后效果会一直留着。
只在导出/宿主页面的真实鼠标交互时运行，PowerPoint 编辑态不触发，需在导出后验证。
不要在 Hover Script 里调用 WriteTag*。运行端只允许真实点击或 Pointer Button 按下/释放动作获取写入能力；悬停应保持为视觉反馈。