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

本是古典何须时尚 2024-04-24 21:00 85阅读 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总页数。**

![bc29d0677c30be0eacbb3e5dd0189c9a.png][]

> **上图为根据后端返回的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 ######

![4510e64031f0f1f96f574db6629f8839.png][]  
![5d36cfecc1c09a10051a298d7edcd22e.png][]  
注意：代码中需要注释的那一行有的版本路径不一样  
有的是：`// 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这种错了，可以正常预览了！ ######

![df05c14d30b69bee37aa9eb4e4c3ac17.png][]

##### 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')];

![c61b86519269e0f111a8235448110f95.png][]

##### 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文件，也可以达成想要的效果。 ######

[bc29d0677c30be0eacbb3e5dd0189c9a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/24/435a21f7319a4d6bafdb37019f329991.png
[4510e64031f0f1f96f574db6629f8839.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/24/1ff097177db94a15828f710fbf2e3138.png
[5d36cfecc1c09a10051a298d7edcd22e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/24/e12dee6e6a734019b66e8c1811559f82.png
[df05c14d30b69bee37aa9eb4e4c3ac17.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/24/8e825ef060684c5d8320c2b8e45b4d57.png
[c61b86519269e0f111a8235448110f95.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/24/2fc0eea2b419491a8091beed2f82b309.png