如何在pdf-lib中确定自动换行文本的高度？

使用pdf-lib的drawText方法可以实现文本自动换行，但官方未提供直接获取自动换行后文本总高度的API，导致无法准确调用moveDown移动光标，也无法判断是否需要新增页面。解决思路是提前模拟文本换行逻辑，计算出行数和总高度，具体实现如下：

1. 实现文本换行计算函数 #

通过font.widthOfTextAtSize方法计算文本宽度，模拟drawText的自动换行规则，拆分文本并统计行数：

function calculateTextLines(text, font, fontSize, maxWidth, wordBreaks = [' ']) {
  const lines = [];
  // 按分隔符拆分文本（保留分隔符）
  const words = text.split(new RegExp(`(${wordBreaks.join('|')})`));
  let currentLine = '';

  for (const word of words) {
    const testLine = currentLine + word;
    const testWidth = font.widthOfTextAtSize(testLine, fontSize);
    
    // 如果当前行加新单词不超过最大宽度，或者当前行为空，则合并
    if (testWidth <= maxWidth || currentLine === '') {
      currentLine = testLine;
    } else {
      // 否则将当前行存入，新单词作为新行起始
      lines.push(currentLine);
      currentLine = word;
    }
  }
  
  // 存入最后一行
  if (currentLine) lines.push(currentLine);
  return lines;
}

2. 结合计算结果处理光标移动与分页 #

利用上述函数得到文本行数后，即可计算总高度，进而判断分页需求，并完成光标定位：

import { PDFDocument, StandardFonts } from 'pdf-lib';

const doc = await PDFDocument.create();
const font = await doc.embedFont(StandardFonts.TimesRoman);
let page = doc.addPage();

// 配置参数
const fontSize = 20;
const lineHeight = 25;
const maxWidth = 200;
const pageMargin = 50; // 页面边距
const someLongText = "这里是需要自动换行的长文本内容，用来测试多行显示的情况，文本长度足够长，会被拆分成多行甚至需要跨页面显示。";

// 计算文本行数与总高度
const lines = calculateTextLines(someLongText, font, fontSize, maxWidth);
const textHeight = lines.length * lineHeight;

// 获取当前光标位置与页面可用空间
const currentY = page.getPosition().y;
const pageHeight = page.getHeight();
const availableHeight = currentY - pageMargin;

// 判断是否需要分页
if (availableHeight < textHeight) {
  page = doc.addPage();
  // 重置光标到新页面顶部（减去边距）
  page.moveTo(pageMargin, pageHeight - pageMargin);
}

// 绘制自动换行文本
page.drawText(someLongText, { 
  font, 
  size: fontSize, 
  lineHeight, 
  maxWidth, 
  wordBreaks: [' '] 
});

// 移动光标到文本下方（行数即为需要下移的次数）
page.moveDown(lines.length);

原理说明 #

该方案通过模拟drawText的内部换行逻辑，确保计算出的行数与实际绘制的行数完全一致。利用font.widthOfTextAtSize获取准确的文本宽度，结合设定的maxWidth拆分文本，最终通过行数乘以lineHeight得到文本总高度，从而解决光标定位和分页判断的问题。

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