配置

针对您的特定用例优化 Taffy。

Taffy 开箱即用,但您可以根据性能、精度或资源约束进行调优。

容量预分配

如果您大约知道需要多少节点,可以使用容量初始化树以减少内存重新分配并提高启动性能。

Loading Preview…

舍入设置

控制布局值是吸附到整数(像素)还是保持精确浮点数。

设置函数描述
启用舍入tree.enableRounding()默认。将值舍入到最近的像素。防止 UI 中出现模糊边框。
禁用舍入tree.disableRounding()使用高精度浮点数。最适合矢量图形或可缩放 UI。
Loading Preview…

内存管理

尽管 Taffy 的 JavaScript 绑定使用 FinalizationRegistryTaffyTree 对象被垃圾回收时自动清理 WASM 内存,但在频繁创建树的高性能应用(如游戏循环)中,仅依赖 GC 可能是不够的。

为了防止 WASM 堆中的内存峰值或泄漏,您应该显式管理内存:

  • 重用(推荐): 使用 .clear() 重置树而不释放其内存分配。这非常适合游戏循环或递归布局,因为它避免了持续的分配开销。
  • 销毁: 如果您完全完成了树的使用并希望立即释放其内存,请使用 .free()
const tree = new TaffyTree(); // ... 使用树 ... // 选项 1:重用树(推荐) // 清除所有节点但保持已分配的内存 tree.clear(); // 选项 2:完全释放 tree.free();

下一步

© 2026 ByteLand Technology Limited