多行文本计算

[wvw2yyb56w-rgb]

求问：n列 m行的明细表格开启文本自动换行，无论n/m多大，渲染时都会遍历 nm个单元格吗

[github-actions[bot]]

@wvw2yyb56w-rgb 您好！以下是关于您问题的自动回复：

在 S2 中，当明细表格开启文本自动换行时，无论表格的 n 列和 m 行有多大，S2 都只会渲染当前可视区域内的单元格，而不是遍历所有的 n*m 个单元格 。

S2 通过“按需渲染”的策略来优化性能 。具体实现如下：

1. 计算可视区域单元格索引：S2 会根据当前的 scrollX 和 scrollY 值，计算出当前可视视窗中的单元格节点索引集合 。这个过程由 calculateXYIndexes 方法完成 。
2. 对比索引差值：S2 会对比当前可视视窗节点索引集合和上次索引集合的差值，找出需要新增和删除的单元格 。这个过程由 diffPanelIndexes 方法完成 。
3. 渲染和删除：S2 针对新增的节点进行渲染，对需要删除的节点进行移除 。

即使开启了多行文本，S2 也会根据文本的实际高度自适应调整单元格高度 ，并且在计算布局时会优化多行文本的渲染性能 。

Notes

用户的问题聚焦于“多行文本计算”和“渲染时是否遍历所有单元格”。S2 的核心优化之一就是“按需渲染”，即只渲染可视区域内的单元格，而不是全部遍历 。这与多行文本的开启与否无关，而是 S2 整体的渲染策略。因此，即使开启了多行文本，也不会导致遍历所有 n*m 个单元格。

---

此回复由 AI 助手自动生成（DeepWiki）。如有任何问题，我们的团队会尽快跟进。

[Alexzjt]

• 不开启换行：布局 O(1)，行高是常量，无需遍历
• 开启换行：布局 O(n×m)，必须遍历每个单元格测量文本高度，才能确定每行的最终高度
  布局阶段会遍历 n × m 个单元格来计算行高。但渲染阶段只绘制可视区域内的单元格。

S2 的流程分为两个阶段：

1. 布局阶段 — 遍历全部 n × m 单元格

核心代码在 table-facet.ts:215-245 的 presetRowCellHeightIfNeeded 方法。当 maxLines > 1 && wordWrap 开启时，calculateRowOffsets 会对 每一行数据 调用 presetRowCellHeightIfNeeded：

data.forEach((_, rowIndex) => {
  this.presetRowCellHeightIfNeeded(rowIndex);  // 每行
  ...
});

而 presetRowCellHeightIfNeeded 内部遍历了 所有列：

const maxDataCellHeight = max(
  colLeafNodes.map((colNode) => {
    const viewMeta = this.getCellMeta(rowIndex, colNode.colIndex);
    return this.getDataCellAdaptiveHeight(viewMeta!);  // 每列
  }),
);

所以布局阶段确实是 O(n × m) 的复杂度，必须遍历所有单元格来计算每行的自适应高度，因为每行的最终高度取决于该行中最高的那个单元格。

不过有两个优化手段：

• 文本高度缓存：base-facet.ts:538-539 使用 textWrapNodeHeightCache（LRU，容量 500）以 fieldValue + maxTextWidth 为 key 缓存已计算的高度，相同文本内容不会重复测量
• 共享临时单元格：base-facet.ts:519 复用单个 textWrapTempRowCell 实例测量，避免大量实例化触发 GC

2. 渲染阶段 — 仅渲染视口内单元格

realDataCellRender 通过 calculateXYIndexes 计算当前滚动位置下可视区域的行列范围 [xMin, xMax, yMin, yMax]，只对 diff 出新增的单元格 调用 createDataCell，离开视口的单元格会被移除。这是虚拟滚动，渲染量与视口大小相关，与 n/m 无关。

总结

阶段	遍历范围	复杂度
布局（算行高）	全部 n × m 单元格	O(nm)，有 LRU 缓存优化
渲染（画单元格）	仅视口内单元格	O(viewport)

所以如果数据量很大（如 100 列 × 10 万行），开启自动换行的 布局阶段 确实会成为性能瓶颈，因为必须遍历全部 1000 万个单元格来计算每行高度。渲染阶段则不受影响。