Runtime API / Method

SceneApi.findByName

在指定语义 Scene 范围内按精确节点名查找全部稳定节点,并始终返回 RuntimeNode 数组。

使用说明

查询区分大小写,保留重复名字,并按确定性的语义场景树顺序返回。没有匹配或 scope 无法解析时返回 [],不会返回 null。

const icons = ctx.scene.findByName('tag-close-icon', {
scope: ctx.nodeId,
});

省略 scope 时从当前 Scene 根查询;scope 可以是节点 ID、RuntimeNode,或当前 Flamo Instance 内的 'global'。结果只包含 Artifact、instance-scoped 和 Scene 创建节点,不会遍历或返回当前 ECS clone。需要当前 Slot/Variant 的物理内容时使用 ctx.mounted;如果目标只用于响应事件,优先使用 ctx.delegate(),它会把动态查询与 canonical 事件路径匹配起来。

参数

namestring
optionsSceneNameQueryOptions