Runtime API / Method

NodeScriptContext.onNode

把统一事件监听直接绑定到当前脚本作用域内的稳定 role 或节点引用。

使用说明

ref 优先解析 Artifact 中声明的 role,也可以是当前 Scene 能解析的节点引用。它适合语义稳定且基数明确的内部节点;variant 中可能动态出现、消失或重复的命名节点应使用 ctx.delegate()。

注册监听不会把显式 interactive: false 或 mode: 'disabled' 改回可交互。

参数

refstring
eventK
handler{ ... }
optionsEventListenerOptions