性能

保持 Taffy 布局快速运行的技巧。

Taffy 旨在高效和高性能，但特定模式会影响性能。

1. 预分配容量

如果您知道节点数量，使用 withCapacity 避免重新分配。

2. 增量布局

Taffy 在输入约束不变且缓存有效时复用结果。样式或子节点关系变化会使相关缓存失效；父级尺寸变化也可能要求重新计算未直接修改的子节点。

原地修改 context 对象、字体等外部测量数据，或替换测量函数后，应对受影响的叶子调用 markDirty()。setNodeContext() 会自动标记该节点及祖先；getNodeContextMut() 本身不会。详见测量函数。

常见陷阱

1. 过度嵌套

每一层深度都会增加递归算法的复杂性。

• 坏：View -> View -> View -> Button 仅仅为了内边距。
• 好：在父节点上使用 padding 而不是包装器节点。

2. 深度测量函数

自定义测量函数（用于文本/图像）被频繁调用。

• 优化：确保您的测量回调很快。避免在测量内进行 DOM 回流或繁重计算。

优化模式

重用样式

在紧密循环中创建 Style 对象（例如游戏渲染）在 JS 中可能很昂贵。尽可能重用定义对象。

// ✅ 好
const tree = new TaffyTree();
const ITEM_STYLE = new Style({ flexGrow: 1 });
for (let i = 0; i < 1000; i++) {
  tree.newLeaf(ITEM_STYLE);
}

// ❌ 如果项目相同则避免
const tree = new TaffyTree();
for (let i = 0; i < 1000; i++) {
  tree.newLeaf(new Style({ flexGrow: 1 }));
}

批量属性访问

使用批量 getter 和 setter 最小化 WASM 桥接开销。

样式批量更新： 不要逐个设置属性：

const style = new Style();
// ❌ 多次调用 = 高开销
style.display = Display.Flex;
style.width = 100;
style.height = 100;

使用 set()：

const style = new Style();
// ✅ 单次调用 = 低开销
style.set({
  display: Display.Flex,
  width: 100,
  height: 100,
});

布局批量读取： 不要单独读取布局属性：

const tree = new TaffyTree();
const node = tree.newLeaf(new Style());
tree.computeLayout(node, { width: 100, height: 100 });

// ❌ 多次调用
const layout = tree.getLayout(node);
const x = layout.x;
const y = layout.y;
const w = layout.width;
const h = layout.height;

使用 get()：

const tree = new TaffyTree();
const node = tree.newLeaf(new Style());
tree.computeLayout(node, { width: 100, height: 100 });

// ✅ 单次调用返回值数组
const layout = tree.getLayout(node);
const [x, y, w, h] = layout.get("x", "y", "width", "height");

基准测试

使用 performance.now() 测量您的布局过程。

const tree = new TaffyTree();
const root = tree.newLeaf(new Style());

const start = performance.now();
tree.computeLayout(root, { width: 1000, height: 1000 });
const end = performance.now();
console.log(`Layout took ${end - start}ms`);

下一步

• 测量函数
• 调试布局