申请表已经在页面里填完,点击“下载”却又拿到一份空白表。这类问题先别急着改表单字段:检查下载按钮究竟下载了什么。
如果按钮仍指向最初的 template.pdf,或重新请求了原文件地址,它得到的就是原模板。要交付填写后的副本,应从当前 PDF 实例导出文档数据,再触发下载。React 里显示了“提交成功”,也不代表这些值已经写进 PDF。
先确认用户填的是 PDF 字段
React 页面上的 <input>、PDF 里的表单域和盖在页面上的文字,是三种不同的数据。把网页输入框里的姓名更新到 useState,不会自动更新 PDF;在空白处添加一段文字,也不等于创建了可继续填写的表单域。
使用 ComPDF Web SDK 填写已有申请表时,先确认文件包含适用的 AcroForm 字段。可以按表单填写指南点击字段输入内容,完成后点一下 PDF 页面空白处,提交当前字段的修改。
如果原文件只有横线,没有字段,应先决定:这份文件只需要填一次,还是要制作一份可重复分发的表单模板。后者需要创建字段;本文处理的是“已有字段、填写后下载”的路径,不把普通页面输入框当成 PDF 字段。
路径示意:从当前 PDF 实例导出,重新打开下载副本确认。
下载当前实例,而不是再次请求原地址
下面的按钮用于已经初始化、并加载完文档的 ComPDF 实例。父组件在 documentLoaded 事件后把 documentViewer 和 loaded=true 传进来;切换文档时先设回未就绪。完整资源部署和许可配置可按React 接入步骤准备。
import { useState } from "react";
export function FilledPdfDownload({ documentViewer, loaded }) {
const [exporting, setExporting] = useState(false);
const [message, setMessage] = useState("");
async function downloadFilledPdf() {
if (!loaded || !documentViewer || exporting) return;
setExporting(true);
setMessage("");
try {
const doc = documentViewer.getDocument();
const data = await doc.getFileData();
if (!data || data.byteLength === 0) {
throw new Error("没有取得 PDF 数据,请检查文档是否已就绪。");
}
const blob = new Blob([data], { type: "application/pdf" });
const url = URL.createObjectURL(blob);
const link = document.createElement("a");
link.href = url;
link.download = "application-filled.pdf";
document.body.appendChild(link);
link.click();
link.remove();
// 给浏览器消费下载地址的机会,再释放临时 URL。
setTimeout(() => URL.revokeObjectURL(url), 1000);
setMessage("已发起下载,请打开下载文件核对填写结果。");
} catch (error) {
setMessage(error instanceof Error ? error.message : "导出失败,请重试。");
} finally {
setExporting(false);
}
}
return (
<section>
<p>填完最后一个字段后,先点一下 PDF 页面空白处。</p>
<button
type="button"
disabled={!loaded || exporting}
onClick={downloadFilledPdf}
>
{exporting ? "正在导出…" : "下载填写后的 PDF"}
</button>
<p role="status">{message}</p>
</section>
);
}
关键调用是 documentViewer.getDocument().getFileData(),与保存文档指南一致。不要把 getFileData() 换成 fetch(initialDoc):后者重新下载原地址,与当前实例里用户做了什么没有必然联系。
这段代码展示导出按钮的接法,不是包含初始化、文件权限和服务器存储的完整应用。它根据当前文档数据创建 Blob;设置 application/pdf 只声明类型,不证明字段已经正确保存。文件内容仍要通过重新打开检查。
父组件需要处理的两个时机
文档何时可操作。 实例初始化完成与文件加载完成不是同一时刻。以当前版本的 documentLoaded 事件设置就绪状态,加载失败则显示错误,不要让用户面对一直可点击的下载按钮。
导出时是否允许换文件。 示例面向单份申请表。若页面还有附件切换、重新上传或模板版本选择,导出期间应冻结当前任务或明确捕获所需文档版本,防止按钮名称、当前选中项与导出对象不一致。不要把上一份文档的就绪状态沿用给下一份。
需要服务器归档时,再把同一份导出的 Blob 上传到自己的接口。只有服务端确认保存成功并记录对应申请与版本,页面才能显示“已归档”;浏览器开始下载与服务器保存是两个动作。
用自己的申请表检查这五件事
- 填写一处文字、一个允许为零的数值,以及一组选项;最后一个字段填完后点页面空白处,再导出。
- 关闭预览,打开刚下载的
application-filled.pdf,不要误开原模板;检查文字、零值和选项是否都在。 - 如果接收人还要继续填写,确认字段仍可选中和修改。需要保留字段时不要在这条导出路径上默认执行扁平化。
- 输入较长文字,检查重开后是否溢出、被裁切或显示不全;有字段值不代表读者能看见完整内容。
- 在实际接收方使用的阅读器中再打开一次;如果还有服务器保存,下载归档版本再做同样核对。
若重开文件是空白,依次核对“是否真正写入 PDF 字段 → 当前字段是否提交 → 是否从当前实例导出 → 是否打开了正确副本”。这比看到空白后就重复下载、重新填写,更容易定位问题。
React 负责就绪状态、按钮交互和业务提交,ComPDF 负责 PDF 字段操作与文档导出。先把一份申请表的填写、导出、重开检查做清楚,再增加上传归档或多附件功能,用户拿到的才是自己刚填过的文件。