pdfh5.js 基于pdf.js和jQuery，web/h5/移动端PDF预览手势缩放插件。
-
注意：本地绝对路径地址不能加载，跨域问题用代理或者服务端解决。
-
注意：svg模式渲染存在缺陷，只能渲染普通pdf，带签名、印章的可能会渲染不全，报错，pdf.js官方目前没有给出解决方案
-
注意：canvas模式本质是图片，默认进去的时候，图片在手机端被缩放，不是原分辨率，所以失真模糊。所以需要放大查看pdf
example/test是vue使用示例，vue示例展示axios调用接口展示pdf，跨域代理，相对路径等方法
example/react-test是react使用示例
- 2020.07.15 更新： 修复同时渲染多个pdf内容错乱bug
- 1.引入css
<link rel="stylesheet" href="css/pdfh5.css" />- 2.创建div
<div id="demo"></div>- 3.依次引入js
<script src="js/pdf.js" type="text/javascript" charset="utf-8"></script>
<script src="js/pdf.worker.js" type="text/javascript" charset="utf-8"></script>
<script src="js/jquery-1.11.3.min.js" type="text/javascript" charset="utf-8"></script>
<script src="js/pdfh5.js" type="text/javascript" charset="utf-8"></script>- 4.实例化
var pdfh5 = new Pdfh5('#demo', {
pdfurl: "./default.pdf"
});- 1.安装
npm install pdfh5
- 2.使用
<template>
<div id="app">
<div id="demo"></div>
</div>
</template>
<script>
import Pdfh5 from "pdfh5";
export default {
name: 'App',
data() {
return {
pdfh5: null
};
},
mounted() {
//实例化
this.pdfh5 = new Pdfh5("#demo", {
pdfurl: "../../static/test.pdf"
});
//监听完成事件
this.pdfh5.on("complete", function (status, msg, time) {
console.log("状态：" + status + "，信息：" + msg + "，耗时：" + time + "毫秒，总页数：" + this.totalNum)
})
}
}
</script>
<style>
@import "pdfh5/css/pdfh5.css";
*{
padding: 0;
margin: 0;
}
html,body,#app {
width: 100%;
height: 100%;
}
</style>- pdfh5实例化的时候传两个参数，selector选择器，options配置项参数，options可以不填写，会自动获取浏览器地址栏？file=后面的地址。会返回一个pdfh5实例对象，可以用来操作pdf，监听相关事件
var pdfh5 = new Pdfh5(selector, options);| 参数名称 | 类型 | 取值 | 是否必须 | 作用 |
|---|---|---|---|---|
| selector | {String} | - | √ | pdfh5的容器选择器 |
| options | {Object} | - | × | pdfh5的配置项参数 |
- 示例： 配置项参数 lazy:true 开启懒加载，默认是false,不开启懒加载
var pdfh5 = new Pdfh5('#demo', {
pdfurl: "./default.pdf",
lazy:true
});| 参数名称 | 类型 | 取值 | 作用 |
|---|---|---|---|
| pdfurl | {String} | - | pdf地址 |
| URIenable | {Boolean} | true、false， 默认false | true开启地址栏file参数 |
| data | {String(blob)/Array(arraybuffer) | - | pdf文件流 ，与pdfurl二选一 |
| renderType | {String} | "canvas"、"svg"，默认"canvas" | pdf渲染模式 |
| lazy | {Boolean} | true、false， 默认false | 是否开启懒加载 |
| maxZoom | {Number} | 最大倍数3 | 手势缩放最大倍数 |
| scale | {Number} | 最大比例5，默认1.5 | pdf渲染的比例 |
| scrollEnable | {Boolean} | true、false， 默认true | 是否允许pdf滚动 |
| zoomEnable | {Boolean} | true、false， 默认true | 是否允许pdf手势缩放 |
| cMapUrl | {String} | 默认"https://www.gjtool.cn/cmaps/" | 解析pdf时，特殊情况下显示完整字体的cmaps文件夹路径，例如 cMapUrl:"https://unpkg.com/pdfjs-dist@2.0.943/cmaps/" |
| limit | {Number} | 默认0 | 限制pdf加载最大页数 |
| logo | {Object} | {src:"pdfh5.png",x:10,y:10,width:40,height:40}src水印图片路径（建议使用png透明图片），width水印宽度，height水印高度，以每页pdf左上角为0点，x、y为偏移值。 默认false | 给每页pdf添加水印logo |
| goto | {Number} | 默认0 | 加载pdf跳转到第几页 |
| textLayer | {Boolean} | true、false， 默认false | 是否开启textLayer，可以复制文本 |
$.ajax({
url: "https://www.gjtool.cn/pdfh5/git.pdf", //假设这是pdf文件流的请求接口
type: "get",
mimeType: 'text/plain; charset=x-user-defined',//jq ajax请求文件流的方式
success: function (data) {
var pdfh5 = new Pdfh5('#demo', {
data: data
});
}
});$.ajax({
url: "https://www.gjtool.cn/pdfh5/git.pdf", //假设这是pdf文件流的请求接口
type: "get",
mimeType: 'text/plain; charset=x-user-defined',//jq ajax请求文件流的方式
success: function (data) {
var rawLength = data.length;
var array = new Uint8Array(new ArrayBuffer(rawLength));
for (i = 0; i < rawLength; i++) {
array[i] = data.charCodeAt(i) & 0xff;
}
var pdfh5 = new Pdfh5('#demo', {
data: array
});
}
});$.ajax({
url: "https://www.gjtool.cn/pdfh5/git.pdf", //假设这是pdf文件流的请求接口
type: "get",
mimeType: 'text/plain; charset=x-user-defined',//jq ajax请求文件流的方式
success: function (data) {
var rawLength = data.length;
var array = [];
for (i = 0; i < rawLength; i++) {
array.push(data.charCodeAt(i) & 0xff);
}
var pdfh5 = new Pdfh5('#demo', {
data: array
});
}
});axios.get("https://www.gjtool.cn/pdfh5/git.pdf",{
responseType:"arraybuffer"
}).then(res=>{
this.pdfh5 = new Pdfh5('#demo', {
data: res.data
});
})- 示例： 是否允许pdf滚动
pdfh5.scrollEnable(true) //允许pdf滚动
pdfh5.scrollEnable(false) //不允许pdf滚动| 参数名称 | 类型 | 取值 | 作用 |
|---|---|---|---|
| scrollEnable | {Boolean} | true、false， 默认true | 是否允许pdf滚动(需要在pdf加载完成后使用) |
| zoomEnable | {Boolean} | true、false， 默认true | 是否允许pdf手势缩放(需要在pdf加载完成后使用) |
| show | {Function} | 带一个回调函数 | pdfh5显示 |
| hide | {Function} | 带一个回调函数 | pdfh5隐藏 |
| reset | {Function} | 带一个回调函数 | pdfh5还原 |
| destroy | {Function} | 带一个回调函数 | pdfh5销毁 |
| on | {String, Function} | String：监听的事件名，Function：监听的事件回调 | on方法监听所有事件 |
| goto | {Number}} | Number:要跳转的pdf页数 | pdf跳转到第几页（pdf加载完成后使用） |
- 示例： 监听pdf准备开始渲染，此时可以拿到pdf总页数
pdfh5.on("ready", function () {
console.log("总页数：" + this.totalNum)
})| 参数名称 | 回调 | 作用 |
|---|---|---|
| init | {Function} | 监听pdfh5开始初始化 |
| ready | {Function} | 监听pdf准备开始渲染，此时可以拿到pdf总页数 |
| error | {Function(msg,time))} | 监听加载失败，msg信息，time耗时 |
| success | {Function(msg,time))} | 监听pdf渲染成功，msg信息，time耗时 |
| complete | {Function(status, msg, time)} | 监听pdf加载完成事件，加载失败、渲染成功都会触发。status有两种状态success和error |
| render | {Function(currentNum, time, currentPageDom)} | 监听pdf渲染过程，currentPageDom当前加载的pdf的dom,currentNum当前加载的pdf页数, |
| zoom | {Function(scale)} | 监听pdf缩放，scale缩放比例 |
| scroll | {Function(scrollTop)} | 监听pdf滚动，scrollTop滚动条高度 |
| backTop | {Function} | 监听回到顶部按钮的点击事件回调 |
| zoomEnable | {Function(flag)} | 监听允许缩放，flag：true，false |
| scrollEnable | {Function(flag)} | 监听允许滚动，flag：true，false |
| show | {Function} | 监听pdfh5显示 |
| hide | {Function} | 监听pdfh5隐藏 |
| reset | {Function} | 监听pdfh5还原 |
| destroy | {Function} | 监听pdfh5销毁 |
- 感谢打赏！请打赏的童鞋留下github、QQ、微信 。然后，我会对打赏过的童鞋的问题及时响应。（当然是在我不忙的时候啦）
- 相比打赏，点star还要重要些，请各位走过路过帮忙点下star，万分感谢
- QQ群：651601340