PDF.js基于HTML5构建的可移植的PDF查看器

PDF.js

PDF.js 是一款基于 HTML5 构建的可移植文档格式 (PDF) 查看器。

PDF.js 由社区驱动,并由 Mozilla 提供支持。我们的目标是创建一个基于 Web 标准的通用 PDF 解析和渲染平台。

入门

在线演示

请注意,“现代浏览器”版本假定原生支持最新的 JavaScript 功能;另请参阅此 wiki 页面

浏览器扩展

Firefox

PDF.js 内置于 Firefox 19 及更高版本中。

Chrome

  • 您可以从 Chrome 网上应用店 安装 Chrome 官方扩展程序。
    此扩展程序由 @Rob--W 维护。
  • 构建您自己的扩展程序 - 按照下文说明获取代码并执行 npx gulp chromium。然后打开
    Chrome,转到 Tools > Extension,并从 build/chromium 目录加载(未打包的)扩展程序。

获取代码

要获取当前代码的本地副本,请使用 git 克隆:

shell 复制代码
git clone https://github.com/mozilla/pdf.js.git
$ cd pdf.js

接下来,通过官方软件包nvm 安装 Node.js。如果一切顺利,请安装
PDF.js 的所有依赖项:

shell 复制代码
$ npm install

最后,您需要启动本地 Web 服务器,因为某些浏览器不允许
使用 file:// URL 打开 PDF 文件。运行:

shell 复制代码
$ npx gulp server

然后您就可以打开:

请记住,这假设您使用的是最新版本的 Mozilla Firefox;有关 PDF.js 库的非开发用途,请参阅 构建 PDF.js

您也可以通过打开以下命令在右侧查看所有测试 PDF 文件:

构建 PDF.js

要将所有 src/ 文件打包成两个生产脚本并构建通用
查看器,请运行:

shell 复制代码
$ npx gulp generic

如果您需要支持旧版浏览器,请运行:

shell 复制代码
$ npx gulp generic-legacy

这将在 build/generic/build/ 目录(分别为 build/generic-legacy/build/)中生成 pdf.jspdf.worker.js
这两个脚本都是必需的,但只需包含 pdf.js,因为 pdf.worker.js
pdf.js 加载。PDF.js 文件较大,应将其压缩以适应生产环境。

在 Web 应用程序中使用 PDF.js

要在 Web 应用程序中使用 PDF.js,您可以选择使用库的预构建版本
或从源代码构建。我们以 pdfjs-dist 的名称提供预构建版本,供 NPM 使用。
有关更多信息和示例,请参阅
wiki 页面 中关于此主题的内容。

通过 CDN 引入

PDF.js 托管在多个免费 CDN 上:

学习

您可以使用以下实时演示,直接在浏览器中使用 PDF.js API:

更多示例可在 examples 文件夹 中找到。其中一些示例使用了 pdfjs-dist 包,您可以通过 npx gulp dist-install 命令在此 repo 目录中构建和安装该包。

如需了解 PDF.js 代码,请查看我们的贡献者 Julian Viereck 的演示:

更多学习资源请访问:

API 文档请访问:

问题

查看我们的常见问题解答并获取常见问题的答案:

在 Matrix 上与我们交流:

提交问题:

关于项目

PDF.js 是一款基于 HTML5 构建的可移植文档格式 (PDF) 查看器。 PDF.js 由社区驱动,并由 Mozilla 提供支持。我们的目标是创建一个基于 Web 标准的通用 PDF 解析和渲染平台。
Apache-2.0
Javascript
52,038
10483
1119
2011-04-26
2025-10-11

增长趋势 - stars