使用pdf-lib填充PDF表单后字段字体属性丢失问题求助

问题描述 #

使用pdf-lib填充PDF表单时，代码能正常填充内容并显示指定字体，但在Acrobat中查看字段属性时，字体属性为空（原表单字段已设置字体）。用户重新编辑字段时会自动使用默认字体，而非预设字体。已尝试form.defaultFontCache.value、defaultUpdateAppearances、updateFieldAppearances等方法，均未解决问题。

填充代码如下：

const pdfDoc = await PDFDocument.load(existingPdfBytes);

pdfDoc.registerFontkit(fontkit);
const cambriaFont = await pdfDoc.embedFont(fs.readFileSync('./fonts/cambria-font-0346.ttf'));

const form = pdfDoc.getForm();

const fieldSecondName = form.getTextField('second_name');
fieldSecondName.setText('Bradburry');
fieldSecondName.updateAppearances(cambriaFont);

已尝试的无效方法：

form.defaultFontCache.value = cambriaFont;

fieldSecondName.defaultUpdateAppearances(cambriaFont);

form.updateFieldAppearances(cambriaFont);

解决方案 #

问题核心在于updateAppearances仅更新字段的外观显示，未设置字段的默认字体属性（DA字典）。需要手动将字体注册到表单资源，并指定字段的默认外观规则。

完整修正代码 #

const pdfDoc = await PDFDocument.load(existingPdfBytes);

pdfDoc.registerFontkit(fontkit);
const cambriaFont = await pdfDoc.embedFont(fs.readFileSync('./fonts/cambria-font-0346.ttf'));

const form = pdfDoc.getForm();

// 将嵌入字体注册到表单默认资源字典（DR），分配引用名称
const fontRef = form.doc.context.registerIndirect(cambriaFont.ref);
form.node.set(PDFName.of('DR'), PDFDict.from({
  Font: PDFDict.from({
    Cambria: fontRef,
  }, form.doc.context),
}, form.doc.context));

const fieldSecondName = form.getTextField('second_name');
fieldSecondName.setText('Bradburry');

// 设置字段默认外观（DA），格式为 "/字体名 字号 Tf 颜色值 rg"
// 示例：12号黑色Cambria字体
fieldSecondName.node.set(PDFName.of('DA'), PDFString.from(`/Cambria 12 Tf 0 0 0 rg`));

// 更新字段外观确保显示一致
fieldSecondName.updateAppearances(cambriaFont);

// 保存处理后的PDF
const modifiedPdfBytes = await pdfDoc.save();

关键说明 #

1. 注册表单资源：通过表单的DR（Default Resources）字典存储字体资源，让字段能正确引用嵌入字体。
2. 设置DA属性：字段的DA（Default Appearance）字符串定义了用户编辑时的默认字体、字号和颜色，Acrobat会直接读取该属性作为编辑时的默认样式。
3. 兼容原有设置：如果原表单字段已有DA配置，可先读取原字符串（fieldSecondName.node.get(PDFName.of('DA'))），仅替换其中的字体部分，保留原有字号、颜色等设置。

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