Flutter中RTL文本方向下computeLineMetrics表现异常问题

问题原因 #

你的分页逻辑存在两个核心问题：

1. RTL文本的索引获取错误：使用textPainter.getPositionForOffset(Offset(left, top))获取行起始索引时，RTL文本的行起始位置对应LineMetrics.right而非left，导致截取的文本边界错误。
2. 行容纳判断逻辑漏洞：原逻辑仅在当前行底部超出页面高度时才分页，但未提前检查当前行是否能被页面剩余空间完整容纳，导致部分行被截断在页面底部。

修复方案 #

替换原_paginate方法，改用TextPainter提供的getStartIndexForLine和getEndIndexForLine直接获取每行的文本索引，同时优化行容纳判断逻辑：

void _paginate(String text, TextStyle textStyle) {
  final pageSize = (_pageKey.currentContext!.findRenderObject() as RenderBox).size;

  debugPrint('Page Size: $pageSize');

  _pageTexts.clear();

  final textSpan = TextSpan(
    text: text,
    style: textStyle,
  );

  final textPainter = TextPainter(
    text: textSpan,
    textDirection: TextDirection.rtl,
  );

  textPainter.layout(
    minWidth: 0,
    maxWidth: pageSize.width,
  );

  List<LineMetrics> lines = textPainter.computeLineMetrics();
  double remainingPageHeight = pageSize.height;
  int currentPageStartLine = 0;

  for (int i = 0; i < lines.length; i++) {
    final line = lines[i];
    final lineHeight = line.baseline + line.descent - (line.baseline - line.ascent);

    // 检查当前行是否能放入剩余页面空间
    if (remainingPageHeight < lineHeight) {
      // 截取当前页文本：从起始行到上一行的结束索引
      final startIndex = textPainter.getStartIndexForLine(currentPageStartLine);
      final endIndex = textPainter.getEndIndexForLine(i - 1);
      _pageTexts.add(text.substring(startIndex, endIndex));

      // 初始化新页面
      currentPageStartLine = i;
      remainingPageHeight = pageSize.height - lineHeight;
    } else {
      remainingPageHeight -= lineHeight;
    }
  }

  // 添加最后一页
  final startIndex = textPainter.getStartIndexForLine(currentPageStartLine);
  _pageTexts.add(text.substring(startIndex));

  setState(() {});
}

修复说明 #

1. 准确获取行索引：使用getStartIndexForLine和getEndIndexForLine直接获取每行的文本起始/结束索引，完全规避RTL/LTR布局差异带来的坐标问题。
2. 提前判断行容纳性：计算每行高度后，先检查剩余页面空间是否能容纳该行，若不能则立即分页，确保每行都能完整显示在某一页中。
3. 正确计算行高度：通过line.baseline + line.descent - (line.baseline - line.ascent)准确计算行的实际占用高度，包含上下留白。

额外优化建议 #

• 若页面存在内边距，需在计算pageSize时扣除对应的padding值，确保分页计算的是实际可显示区域的高度。
• 可以添加对文本样式变化的适配（如不同字号、字体），确保行高度计算始终准确。

内容的提问来源于stack exchange，提问作者burhanaksendir