夜雨聆风学习资料网

ARTICLE · 1373980

pdf.js 不够用?试试这个 PDF 组件

pdf.js 不够用?试试这个 PDF 组件
01
PART
别再自己造工具栏

做过文档需求的都懂:用 pdf.js 把 PDF 渲染出来,基本半天就能搞定;但产品经理随后要高亮、批注、表单填写、盖章签名,你就得一层层自己补 UI。等这些活干完,你会发现这个“顺手做的预览模块”,代码量比主项目还大,还不敢重构,怕一改就把某个客户的批注弄丢。

embed-pdf-viewer 的定位很简单:底层换成 PDFium(Chrome 里跑的那个 PDF 引擎,编译成 WebAssembly 直接在浏览器里运行),解析和渲染都在客户端完成,文件不上传第三方服务器;批注、表单、电子签名、红印脱敏原生就有,工具栏也默认配好。

仓库:https://github.com/embedpdf/embed-pdf-viewer

Apache-2.0,闭源商业项目能直接用,没有密钥、没有服务端依赖,这对做私有化交付的团队挺关键。主包 @embedpdf/viewer 是原生 Web Component,另有 Vue3、React、Svelte 封装,也有不带 UI 的 headless 核心库,想自己画界面也行。

02
PART
PDFium 进了浏览器

先把一件事说清楚:它不是一个 PDF 渲染库。把 PDFium 编译成 WebAssembly 放进 Web Worker,思路是用成熟的 C++ 引擎替代手写渲染逻辑。和 pdf.js 的纯 JS 路线是两条路:pdf.js 赢在轻,它赢在功能全。批注、表单、红印、签名都是引擎级支持,不用在应用层补一层。

架构是插件化的,功能按需开启,支持摇树优化;渲染采用虚拟滚动,打开几百页的合同、报告时,内存占用不会失控。真实业务里,卡顿往往不是样式问题,而是一次性渲染了太多 DOM 节点。

开箱能力大致三块:基础阅读(缩放、旋转、单双页、缩略图、全文检索、复制、打印导出)、批注标记(高亮、下划线、涂鸦、文本注释、图章,其中包含真正能永久抹除内容的脱敏红印,而非盖一层黑框)、表单与签名(填写交互式表单并回写 PDF,手写或图片签名写进文档)。UI 支持明暗主题和自定义配色,也能关掉某些按钮,例如禁下载、禁打印。

落地场景很具体:合同在线签署、文档审阅批注、归档前抹掉敏感信息、内部系统文档预览。实际用下来最省心的是默认那套完整工具栏,省掉的不只是设计交互的时间。

03
PART
两行代码先跑起来
CDN 直接嵌

原生 JS 想先看效果,CDN 最省事,一个 script 加一个自定义标签就行:

<script type="module" src="https://cdn.jsdelivr.net/npm/@embedpdf/viewer@3/dist/embedpdf.js"></script> <embedpdf-viewer src="./demo.pdf" style="height:90vh"></embedpdf-viewer> 

工程化项目换成 npm install @embedpdf/viewer,React、Vue、Svelte 都有对应封装。建议先拿一份静态 PDF 把渲染链路跑通,确认工具栏、缩略图、检索都正常,再接后端真实文件,不然出问题时分不清是组件没起来还是接口没通。

红印是真删,不是盖图层

这块值得单独说。市面上不少“打码”,本质是在文字上盖个黑矩形,复制一下、或者换个解析器拆开 PDF,原文照样躺在里面。这里的红印是永久抹除,处理完导出的文件里根本不存在这段数据。对外发合同、归档材料,这个差别关乎合规,不只是体验。

表单填写与签名回写

交互式表单能直接在浏览器里填,填完回写进 PDF 再导出;签名支持手写和图片导入,写进文档内部,而不是外挂一张图。整条链路在客户端完成,文件不出浏览器,处理证照、协议这类材料时,这点比功能本身更要紧。

踩坑提醒: 别只把 JS 产物拷走。wasm 二进制是单独部署的,本地跑通、上了生产白屏,八成是 wasm 路径不对或 MIME 没配对,服务器得把 application/wasm 配好,否则流式编译会退化甚至直接失败。联调阶段就先验这条,别等上线前夜。

04
PART
体积和 CSP 这笔账

最直接的代价是体积。PDFium 编成 WASM 之后,资源包比 pdf.js 大出一截,首次加载还多一个解析编译的过程。场景如果只是“让用户瞄一眼合同”,上这套引擎有点像用牛刀杀鸡;但凡是需要批注、表单、红印的地方,省下的自研 UI 工时早把这体积赚回来了。

让运维头疼的是部署环节。CSP 规则要放行,缓存头也得跟着调,安全策略收得紧的团队常常卡半天,控制台报错还特别含糊,很容易误判成跨域。

兼容性也不是全覆盖,加密级别较高的 PDF、结构刁钻的老文件偶尔会翻车。所以真做归档、合同这类严肃场景,验收别拿一份规规矩矩的示例文件走个过场,先把业务里最难搞的那批真实文件扔进去跑一遍。

还有一条容易被低估:headless 核心库确实能完全自定义界面,代价是工具栏、缩略图、搜索框全得自己写。图省事就老老实实用带 UI 的版本,想让界面长成自家产品的样子,就得接受这份投入。

05
PART
选型这事,看你要走多远

需求只是“把 PDF 渲染出来看看”,那 pdf.js 依然是最省事的选择:一个脚本引入、一个 canvas 挂载,收工。

可需求里一旦冒出批注、表单回填、签名、脱敏这几个词,性质就变了。你面对的不再是渲染问题,而是编辑器问题:工具栏要自己搭、批注状态要同步、表单字段要做映射、红印还得保证不可逆,每一块都是自研 UI 的深坑。走到这一步,换个自带完整工具栏的引擎,通常比硬扛划算。

真正的分水岭不在功能对比表上,而在你愿不愿意为那几 MB 的 wasm 和配套的部署配置买单。这笔账没有通用答案:页面轻、访问量大,多出来的初始化开销可能正好压垮首屏;内部系统、文档密集的场景里,这点加载成本几乎不值一提。

你们现在的文档预览是怎么做的?有没有哪个坑踩到想推倒重来?评论区聊聊,想看去掉所有包装、只留核心逻辑的最小 demo 拆解,也可以说一声。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料