跳到主要内容

生成器(Spawner)

生成器是使用信号实现的,由于信号的惰性求值,这使得它们的行为难以预测。你可以考虑改用效果。

在未来的版本中,生成器将使用效果重新实现。

有时我们希望给定节点的子节点具有响应性。换句话说,我们希望它们根据某些外部状态发生变化。请看下面的例子:

const count = createSignal(10);

view.add(
<Layout layout>
{range(count()).map(() => (
<Circle size={32} fill={'white'} />
))}
</Layout>,
);

我们首先创建 count 信号,然后使用它的值来生成 N 个圆。

这个例子不具备响应性——更改 count 信号不会改变 Layout 节点内圆的数量。我们可以通过使用一个返回子节点的函数来解决这个问题,而不是直接把它们写出来:

const count = createSignal(10);

view.add(
<Layout layout>
{() => range(count()).map(() => <Circle size={32} fill={'white'} />)}
</Layout>,
);

在本指南中,我们将返回子节点的函数称为生成器(spawner)。与任何其他信号一样,该函数会跟踪其依赖项,并在它们发生变化时重新计算其值。我们可以为 count 信号设置动画,看看它是否生效:

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const count = createSignal(10);

view.add(
<Layout layout>
{() => range(count()).map(() => <Circle size={32} fill={'white'} />)}
</Layout>,
);

yield* count(3, 2, linear).wait(1).back(2);
});

需要记住的是,创建新节点会带来一定的开销。如果我们的生成器恰好生成了大量节点,并且其依赖项每帧都在变化,那么可能会大幅降低播放性能。为了缓解这一问题,我们可以使用对象池,让我们复用相同的节点,而不是每次都重新创建它们:

const count = createSignal(10);

const pool = range(64).map(i => (
<Circle x={i * 32} width={32} height={32} fill={'lightseagreen'} />
));

const layout = createRef<Layout>();
view.add(
<Layout layout ref={layout}>
{() => pool.slice(0, count())}
</Layout>,
);

除了生成器函数之外,不应直接访问对象池。使用父对象上的辅助方法来获取对生成子节点的引用:

// ... continuing from above ...
let spawnedCircles = layout().childrenAs<Circle>();
yield * all(...spawnedCircles.map(circle => circle.scale(1.5, 1).to(1, 1)));

请注意,当生成对象的数量发生变化时,调用 children() 返回的引用可能会失效,访问已失效的对象可能会导致未定义行为。尽量不要长时间保存对生成对象的引用,并尽可能使用 children() 来获取生成对象的最新列表。