vue前端预览pdf并加水印、ofd文件,控制打印、下载、另存,vue-pdf的使用方法以及在开发中所踩过的坑合集

前端 0

根据公司的实际项目需求,要求实现对pdf和ofd文件的预览,并且需要限制用户是否可以下载、打印、另存pdf、ofd文件,如果该用户可以打印、下载需要控制每个用户的下载次数以及可打印的次数。正常的预览pdf很简单,直接调用浏览器的预览就可以而且功能也比较全,但是一涉及到禁止用户打印、另存的话就不可以用浏览器自带的预览方式了。那就只能寻找插件来模拟了,之前在eletron-vue项目中使用过pdfjs以及vue-pdf插件,效果不是特别好,vue-pdf底层其实也是用的pdfjs的东西,当时在客户端项目中莫名的报一些错误(可能是因为版本问题,当时项目比较着急没有太多时间去排坑)果断弃坑选择了iframe预览pdf文件,也可以达到当时项目需求。但是,目前的需求背景是管理端以及门户端想要实现此功能,脱离了electron的限制,我决定还是使用vue-pdf比较靠谱,我也简单安装并测试使用了一下,没有问题可以正常预览本地文件并且并没有报electron中的不知名的错误。下面先来说一下插件的具体使用方法:

1.安装vue-pdf依赖:

npm/yarn i/add vue-pdf

2.import导入并注册依赖(哪个界面需要在哪个界面单独导入即可)

// 单组件引用import pdf from 'vue-pdf' // 然后在component中进行注册components: {  pdf},

3.界面中使用vue-pdf

// 点击分页<div>  <el-button size="small" type="primary"  @click="changePdfPage(0)" class="turn" :class="{grey: currentPage==1}">上一页</el-button>  {{currentPage}} / {{pageCount}}  <el-button size="small" type="primary"  @click="changePdfPage(1)" class="turn" :class="{grey: currentPage==pageCount}">下一页</el-button></div><div class="content" ref="printContent">  <pdf    id="myIframe"    ref="pdfDom"    :src="pdfSrc"     :page="currentPage"     @num-pages="pageCount=$event"     @page-loaded="currentPage=$event"     @loaded="loadPdfHandler">   </pdf></div>// 声明变量data() {  return {    pdfSrc: '', // pdf文件src    pageCount: 0, // pdf文件总页数    currentPage: 1, // pdf文件页码  }},// 获取文件流和文件总页数 async getFileInfo() {  let formData = new FormData();  formData.append('wjid', this.wjid)  formData.append('yhid', this.userId)  let res = await getFileBuffer(formData)  if(res.status === 200){    const blob = new Blob([res.data])    let pageRes = await getFilePages(formData)    this.pdfSrc = URL.createObjectURL(blob)    this.pageCount = pageRes.data.content  }else{  	this.$message({  		message: res.message,  		type: 'error'  	});  }},// 改变PDF页码,val传过来区分上一页下一页的值,0上一页,1下一页changePdfPage (val) {  if (val === 0 && this.currentPage > 1) {    this.currentPage--  }  if (val === 1 && this.currentPage < this.pageCount) {    this.currentPage++  }},// pdf加载时loadPdfHandler (e) {  this.currentPage = 1 // 加载的时候先加载第一页},

以上代码是从后端获取pdf文件的文件流,await getFileBuffer(formData)请求接口赋值给res,根据res的状态值为200进行判断文件流是否成功返回,返回成功后通过new Blob([res.data]) 转换成blob,然后通过URL.createObjectURL(blob)获取pdfSrc。

await getFilePages(formData)接口是单独获取pdf总页数。

上图为根据后端返回的pdf数据流预览的此pdf文件,现在只是把pdf文件显示出来了,目前仅仅成功了一小部分,可以说刚刚把这部分功能最基础的部分弄完,后续还会有控制打印、下载、另存、水印…

我们可以一个一个来实现,首先说一下禁止浏览器的快捷键ctrl+s(保存)、ctrl+p(打印),可以通过以下代码禁止当前界面这两个快捷键的使用,直接上代码:
mounted() {  // 禁止ctrl+S保存   禁止ctrl+P打印  document.addEventListener(    "keydown",    function (event) {      // 禁止ctrl+s      if (event.ctrlKey === true && event.which === 83) {        // console.log('ctrl+s');        event.preventDefault();      }else if(event.ctrlKey === true && event.which === 80) {      // 禁止ctrl+p        event.preventDefault();      }    },    false  );  }
文件下载,界面上写好下载按钮,写好click点击事件以及v-if(控制此用户的下载次数,根据用户每次点击下载按钮后台计算下载次数,如果下载次数达到设置的次数,隐藏下载按钮)直接上代码:
<el-button size="small" class="cz-button" type="primary" v-if="downLoadShow" @click="downloadClick">下载文件</el-button>// 下载方法async downloadClick() {    this.fileName = '' // 获取文件名    let formData = new FormData();    formData.append('wjid', this.wjid)    formData.append('yhid', yhid)    let res = await getFileBufferDl(formData)    // 根据用户id和文件id向后台请求接口返回pdf文件流    const blob = new Blob([res])    const url = window.URL.createObjectURL(blob)     let dom = document.createElement('a')    dom.style.display = 'none'    dom.href = url    dom.setAttribute('download', this.fileName)    document.body.appendChild(dom)    // 执行下载操作    dom.click()    // 下载完成以后向后台发起接口 传入用户id 后台将该用户的下载次数进行加1    ......	},
文件打印,界面上写好下载按钮,写好click点击事件以及v-if(控制此用户的打印次数,根据用户每次点击打印按钮后台计算打印次数,如果打印次数达到设置的次数,隐藏打印按钮)打印需要下载print-js依赖

1.安装依赖

yarn add print-js

2.引入插件

import printJS from 'print-js'

3.使用插件(直接传入文件的路径)

printJS(url)

4.官方文档https://printjs.crabbly.com/

<el-button size="small" style="margin-right: 90px;" class="cz-button" type="primary" v-if="printShow" @click="billPrintClick">打印</el-button>// 打印方法billPrintClick() {    this.$nextTick(async () => {        let formData = new FormData();        formData.append('wjid', this.wjid)        formData.append('yhid', yhid)        let res = await getFileBufferDl(formData)        const blob = new Blob([res])        const url = window.URL.createObjectURL(blob) //URL.createObjectURL(object)表示生成一个File对象或Blob对象        printJS(url)        let resName = await getProfile()        // 下载完成以后向后台发起接口 传入用户id 后台将该用户的下载次数进行加1        ......    })},
文件预览水印,正常加水印流程是java后端把文件加上水印后返回给前端,前端可以直接预览、下载、打印带有水印的文件,之前弄过前端加水印方法也比较简单,从网上找了个前端加水印的例子,简单调整了一下,在这也做下记录:
<div class="content" id="myIframe" ref="printContent">  <pdf ref="pdfDom" :src="pdfSrc" :page="currentPage" @num-pages="pageCount = $event" @page-loaded="currentPage = $event" @loaded="loadPdfHandler"></pdf></div>// 调用方法传入的参数是水印内容根据实际需求而定,我这里写的是获取当前用户的中文用户名直接传入方法里即可this.$nextTick(async () => {  this.setWatermarkContent(resName.data.userInfo.userName);  window.onresize = () => {    this.setWatermarkContent(resName.data.userInfo.userName);  };});// 设置水印setWatermarkContent(resName) {			// 创建canvas容器			let ele = document.createElement("canvas");			ele.width = 250;			ele.height = 200;            // 水印参数对象			let objmsg = {				canvas: ele,				fontText: resName, // 显示的内容,显示方法传入的内容 字符串格式				fontSize: 20, // 水印的字体大小				fontFamily: "microsoft yahei", // 字体 				fontcolor: "#dadbdc", //字体颜色   默认 #dadbdc				rotate: 25, //旋转角度   数字类型				textAlign: "left", //水印文字居中方式:left center right  默认 left			};			this.createWaterMark(objmsg);			this.drawWaterMark(ele); // 将水印canvas遮罩层定位到pdf容器中		},		// 创建canvas水印图片		createWaterMark({ canvas, fontText, fontFamily = "microsoft yahei", fontSize = 30, fontcolor = "#dadbdc", rotate = 30, textAlign = "left" }) {			let ctx = canvas.getContext("2d");			ctx.font = `${fontSize}px ${fontFamily}`;			ctx.rotate((-rotate * Math.PI) / 180);			ctx.fillStyle = fontcolor;			ctx.textAlign = textAlign;			ctx.textBaseline = "Middle";			ctx.fillText(fontText, canvas.width / 6, canvas.height / 2);		},		// 给pdf增加水印遮罩层		drawWaterMark(ele) {			let div = document.createElement("div");			div.style.pointerEvents = "none";			div.style.position = "absolute";			div.style.background = "url(" + ele.toDataURL("image/png") + ") left top repeat";            // 获取容器的宽度和高度			let width = document.getElementById("myIframe").clientWidth || 700;			let height = document.getElementById("myIframe").clientHeight || 700;			div.style.width = width + "px";			div.style.height = height + "px";			document.getElementById("myIframe").appendChild(div);		}

上面主要是介绍vue-pdf、printjs插件以及怎么前端控制下载、另存以及打印功能,那么接下来重点说一下vue-pdf这个插件,总结一下我在开发过程中所遇到过的坑,仅供参考可能解决方法有很多种

分割线分割线,这是一条分割线—分割线分割线,这是一条分割线—分割线分割线,这是一条分割线—分割线分割线,这是一条分割线

1. 本地开发时预览一点毛病都没有,就是build打完包后放到服务器上无法预览报错:提示xxx.worker.js 500 或者 404
解决方法:需要改两个地方:
① 修改依赖下的文件位置:node_modules/vue-pdf/src/vuePdfNoSss.vue



注意:代码中需要注释的那一行有的版本路径不一样
有的是:// var PdfjsWorker = require('worker-loader!pdfjs-dist/build/pdf.worker.js');
有的是:// var PdfjsWorker = require('worker-loader!pdfjs-dist/es5/build/pdf.worker.js');

② 找到项目的vue.config.js 文件,在配置文件中新家下面这段代码
    // 处理vue-pdf打包文件404    config.module    .rule('worker')    .test(//.worker/.js$/)    .use('worker-loader').loader('worker-loader')    .options({        inline: true,        fallback: false,    }).end();
两个地方改完之后再执行yarn run build打包部署到服务器上发现不会报xxx.worker.js 500 或者 404这种错了,可以正常预览了!

2. 线上环境大部分pdf预览都没有问题,但是有个别pdf文件里面的内容显示不全,缺胳膊少腿,不是这个字没显示出来就是那个字丢了的(本地还是没有问题)
解决方法:在网上找了一下,也有人遇到类似问题,原因是缺少相应字体 ,需要在界面上引入CMapReaderFactory,然后把url传进去生成新的路径赋值给this.pdfSrc,就可以解决
import pdf from 'vue-pdf'import CMapReaderFactory from 'vue-pdf/src/CMapReaderFactory'let loadingTask = pdf.createLoadingTask({  url: URL.createObjectURL(blob),  cMapPacked: true,  CMapReaderFactory})this.pdfSrc = loadingTask;
3. 当我们使用上个问题中的CMapReaderFactory时,会引发另外一个问题,就是预览的时候显示空白的问题,显示不全有空白页,控制台还不报错
我也去网上找了相关问题的解决方法,有人说是因为缓存问题,第二次加载时取的是初次加载PDF文件时的语言文件的loadModules的缓存,但是取的过程中导致了失败,返回了空值,修改的时候只需要加上一段话
//加载完语言文件后清除缓存delete require.cache[require.resolve('./buffer-loader!pdfjs-dist-sign/cmaps/'+query.name+'.bcmap')];

4. 打包部署到服务器上后,预览时死活看不到内容,控制器不报错,就是空白,本地开发也没问题
这个问题啥招我都试了,我同时做管理端以及门户端,都需要预览pdf,用的都是vue-pdf,代码逻辑一模一样,而且后台接口也一模一样,门户端开发环境和部署环境一点问题都没有,管理端开发环境没问题部署完以后到线上就是不展示内容,这个问题我改了一天,没办法在本地测试,只能改一点发给现场一个包现场部署一版给我测一下好不好用,一天我给现场发包就发了20个,马上下班的时候我给现场发了个包,和现场哥们说这个不行就暂时换回备份的包吧,说实话我对这个包真没报啥希望。竟然解决了,我听到以后都震惊了改了一天给现场发了20个包,最后这个包啥都没改竟然好用了,我也很诧异,最后发现是我把vue-pdf降了几个版本,什么都没改就好使了。之前用的是最新的"vue-pdf": “4.3.0”,我卸了重新按了个4.0.7的竟然解决了!!!
5. Uncaught SyntaxError: Unexpected token ‘<‘
从接触vue-pdf开始,就感觉不是啥善茬,最开始是在electron-vue项目中接触,安装完依赖以后就报Uncaught SyntaxError: Unexpected token ‘<‘这个错,网上找了好多这个问题的解决方法,但是并没有什么用,最后这个问题也没解决,在electron项目中直接弃坑了,换成iframe预览pdf文件,也可以达成想要的效果。

也许您对下面的内容还感兴趣: