Hover Script 悬停脚本 | Mingcedar Studio

<div class="manual-doc-article manual-doc-article-section"><h2 id="hover-script">交互: Hover Script 悬停脚本</h2>

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

<div class="doc-card-list">

<article class="doc-card doc-card-tip">

<h3 id="hover-script-item-1">功能说明</h3>

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

</article>

<article class="doc-card doc-card-warn">

<h3 id="hover-script-item-2">字段配置</h3>

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

<ul>

<li>Pointer Enter（鼠标移入，文档中也称 Mouse Over）：鼠标进入图形时执行的脚本。</li>

<li>Pointer Leave（鼠标移出，文档中也称 Mouse Out）：鼠标离开图形时执行的脚本，用来还原移入时所做的改动。</li>

<li>脚本里可用的上下文对象：object、objects、event（鼠标相关）以及 tag、page、presentation、shape、hqVisuDesigner 和 globals。</li>

<li>object 指当前图形的 DOM 元素，可直接改它的样式（如 object.style.opacity）；shape.name 是图形名称。</li>

<li>注意：悬停脚本没有 Enable/Condition 启用门（这点和 Click Script 不同），两段脚本会直接执行。</li>

</ul>

<div class="manual-code" data-code-language="text"><div class="manual-code-toolbar"><span>Text</span><span class="manual-code-tools"><small>Text</small><button type="button" data-copy-code data-copied="已复制" data-failed="请选中代码后复制" aria-label="复制代码: Text">复制代码</button><span class="manual-code-status" role="status"></span></span></div><pre tabindex="0" class="docs-code-block shiki github-light" style="background-color:#fff;color:#24292e" tabindex="0"><code><span class="line"><span>// Pointer Enter（鼠标移入）</span></span>

<span class="line"><span>object.style.opacity = "0.7";</span></span>

<span class="line"><span></span></span>

<span class="line"><span>// Pointer Leave（鼠标移出）</span></span>

<span class="line"><span>object.style.opacity = "1";</span></span></code></pre></div>

</article>

<article class="doc-card doc-card-tip">

<h3 id="hover-script-item-3">适用场景</h3>

<p>用于无需点击的高亮和提示。</p>

<ul>

<li>设备图标悬停高亮：鼠标移到泵/阀门上时降低透明度或加描边突出，移开恢复，提示“这个可点”。</li>

<li>临时信息提示：移入时用 hqVisuDesigner 在页面上显示一段说明或边框强调，移出时清除，不打断用户操作。</li>

</ul>

</article>

<article class="doc-card doc-card-warn">

<h3 id="hover-script-item-4">限制与常见问题</h3>

<p>运行与还原要求：</p>

<ul>

<li>移入做的修改不会自动撤销：必须在 Pointer Leave 里写对应的还原逻辑，否则鼠标离开后效果会一直留着。</li>

<li>只在导出/宿主页面的真实鼠标交互时运行，PowerPoint 编辑态不触发，需在导出后验证。</li>

<li>不要在 Hover Script 里调用 WriteTag*。运行端只允许真实点击或 Pointer Button 按下/释放动作获取写入能力；悬停应保持为视觉反馈。</li>

</ul>

</article>

</div>

<div class="docs-note-grid manual-doc-image-grid">

<figure class="docs-note-card manual-doc-image-card" id="hover-script-image-1">

<img src="/WEB_img/HQPPT/current/interaction/hover-script.png" alt="Hover Script 悬停脚本行为编辑器" loading="lazy" decoding="async" />

<figcaption>

<strong>图示 1: Hover Script 编辑器</strong>

<p>分别填鼠标移入（Pointer Enter）和移出（Pointer Leave）两段脚本，移出脚本负责还原。</p>

</figcaption>

</figure>

</div>

</div>