组件分享之前端组件——基于pdf.js在线预览PDF文件
背景
近期正在探索前端、后端、系统端各类常用组件与工具,对其一些常见的组件进行再次整理一下,形成标准化组件专题,后续该专题将包含各类语言中的一些常用组件。欢迎大家进行持续关注。
组件基本信息
- 组件:pdf.js
- 开源协议:Apache-2.0 许可证
- 使用与下载:https://mozilla.github.io/pdf.js/
内容
本次分享的组件是用于在浏览器中在线查看PDF使用的。
下面是其开源库中的描述内容:
PDF.js是使用 HTML5 构建的可移植文档格式 (PDF) 查看器。
PDF.js 由社区驱动并受 Mozilla 支持。我们的目标是创建一个通用的、基于 Web 标准的平台来解析和呈现 PDF。
交互式示例
带有文档加载错误 处理的 Hello World
该示例演示了如何使用 Promise 来处理加载过程中的错误。它还演示了如何等待页面加载和 呈现。
1、创建一个html页面,并在其中增加如下代码
<script src="//mozilla.github.io/pdf.js/build/pdf.js"></script>
<h1>PDF.js 'Hello, world!' example</h1>
<canvas id="the-canvas"></canvas>
2、增加如下CSS样式
#the-canvas {
border: 1px solid black;
direction: ltr;
}
3、在js中增加如下代码进行加载需要在线展示的pdf文件
// 如果提供了来自远程服务器的绝对URL,则在该服务器上配置CORS头。
var url = 'https://raw.githubusercontent.com/mozilla/pdf.js/ba2edeae/examples/learning/helloworld.pdf';
// 通过<script>标签加载,创建访问PDF.js导出的快捷方式。
var pdfjsLib = window['pdfjs-dist/build/pdf'];
// 指定workerSrc属性。
pdfjsLib.GlobalWorkerOptions.workerSrc = '//mozilla.github.io/pdf.js/build/pdf.worker.js';
// 异步下载PDF
var loadingTask = pdfjsLib.getDocument(url);
loadingTask.promise.then(function(pdf) {
console.log('PDF loaded');
// 获取第一页
var pageNumber = 1;
pdf.getPage(pageNumber).then(function(page) {
console.log('Page loaded');
var scale = 1.5;
var viewport = page.getViewport({scale: scale});
// 准备画布使用PDF页面尺寸
var canvas = document.getElementById('the-canvas');
var context = canvas.getContext('2d');
canvas.height = viewport.height;
canvas.width = viewport.width;
// 渲染PDF页到画布上下文
var renderContext = {
canvasContext: context,
viewport: viewport
};
var renderTask = page.render(renderContext);
renderTask.promise.then(function () {
console.log('Page rendered');
});
});
}, function (reason) {
// PDF loading error
console.error(reason);
});
4、这样我们一个简单的使用demo就完成了,上述案例来源于官方案例,有需要的小伙伴可以直接参考https://mozilla.github.io/pdf.js/examples/官方案例详细说明。
本文声明:
知识共享许可协议
本作品由 cn華少 采用 知识共享署名-非商业性使用 4.0 国际许可协议 进行许可。