【免登录下载】pdf.js 前端插件:3 步实现 PDF 在线预览,访客零安装直接看文档
【免登录下载】pdf.js 前端插件:3 步实现 PDF 在线预览,访客零安装直接看文档
pdf.js 前端插件解决的就是网页无法直接打开 PDF 在线预览的难题:把 PDF 地址拼进一行代码,访客就能在浏览器里查看文档,不用下载任何额外软件。
项目定位与核心能力
它本质上是一个开箱即用的 pdf.js 前端资源包,解压后即得到 pdfjs 目录,内含核心渲染脚本 build、预览页 web/viewer.html 以及中文编码映射文件 cmaps。只要你的网站想把 PDF 文档展示给用户,而不希望对方装阅读器或手动下载,都可以直接接入。无论企业官网、资料库还是个人博客都适用。
- 一行代码即可在新窗口弹出预览页,接入成本极低
- 渲染完全跑在浏览器里,用户端无需安装任何软件
- 自带中文 cmaps 映射,中文 PDF 也能正常显示
👇 下面是 pdf.js 快速上手步骤。
快速上手(4 步完成)
-
把仓库里的 pdfjs.zip 解压,将得到的
pdfjs目录整个放到网站静态目录下(例如www/pdfjs/)。 -
确认要展示的 PDF 有一个浏览器能直接访问的网络地址。
-
在页面的按钮事件里执行这一行:
window.open(basePath + '/pdfjs/web/viewer.html?file=' + fileUrl); -
点击按钮,预览窗口即弹出。这里
basePath是pdfjs目录在网站中的地址,fileUrl是待预览 PDF 文件的完整网址。
常见问题与注意
- 预览页 404 或白屏:多半是
basePath与服务器上pdfjs目录的实际位置对不上,改成真实路径即可。 - 窗口能打开但 PDF 加载不出来:检查
fileUrl是否为浏览器可访问的 URL,跨域资源还要允许跨域(CORS)请求。 - 老旧浏览器显示异常:插件依赖较新的 JavaScript 能力,建议引导用户使用主流浏览器的最新版。
- 中文 PDF 字体错乱:请确认部署时把
pdfjs/web/cmaps目录一并带上了,缺了映射文件中文就无法正确渲染。
更多背景可参考 README.md。
一行代码,让 PDF 在线预览变成你的站点标配。愿你的文档展示从此不再踩坑!
登录后查看全文