vue前端预览pdf并加水印、ofd文件,控制打印、下载、另存,vue-pdf的使用方法以及在开发中所踩过的坑合集
阅读原文时间:2023年07月31日阅读:1

根据公司的实际项目需求,要求实现对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文件,也可以达成想要的效果。

手机扫一扫

移动阅读更方便

阿里云服务器
腾讯云服务器
七牛云服务器

你可能感兴趣的文章