实现html导出为pdf

方式一：使用html2canvas和jspdf插件实现

该方式是通过html2canvas将HTML页面转换成图片，然后再通过jspdf将图片的base64生成为pdf文件。实现步骤如下：

1下载插件模块

npm install html2canvas jspdf --save

2定义功能实现方法

在项目工具方法存放文件夹utils中创建htmlToPdf.js文件，代码如下：

import html2Canvas from 'html2canvas'
import JsPDF from 'jspdf'
export default{
  install (Vue, options) {
    Vue.prototype.getPdf = function () {
      // 当下载pdf时，若不在页面顶部会造成PDF样式不对,所以先回到页面顶部再下载
      let top = document.getElementById('pdfDom');
      if (top != null) {
        top.scrollIntoView();
        top = null;
      }
      let title = this.exportPDFtitle;
      html2Canvas(document.querySelector('#pdfDom'), {
        allowTaint: true
      }).then(function (canvas) {
        // 获取canvas画布的宽高
        let contentWidth = canvas.width;
        let contentHeight = canvas.height;
          // 一页pdf显示html页面生成的canvas高度;
        let pageHeight = contentWidth / 841.89 * 592.28;
          // 未生成pdf的html页面高度
        let leftHeight = contentHeight;
          // 页面偏移
        let position = 0;
          // html页面生成的canvas在pdf中图片的宽高（本例为：横向a4纸[841.89,592.28]，纵向需调换尺寸）
        let imgWidth = 841.89;
        let imgHeight = 841.89 / contentWidth * contentHeight;
        let pageData = canvas.toDataURL('image/jpeg', 1.0);
        let PDF = new JsPDF('l', 'pt', 'a4');
        // 两个高度需要区分: 一个是html页面的实际高度，和生成pdf的页面高度
        // 当内容未超过pdf一页显示的范围，无需分页
        if (leftHeight < pageHeight) {
          PDF.addImage(pageData, 'JPEG', 0, 0, imgWidth, imgHeight)
        } else {
          while (leftHeight > 0) {
            PDF.addImage(pageData, 'JPEG', 0, position, imgWidth, imgHeight)
            leftHeight -= pageHeight;
            position -= 592.28;
            // 避免添加空白页
            if (leftHeight > 0) {
              PDF.addPage();
            }
          }
        }
        PDF.save(title + '.pdf')
      })
    }
  }
}

3全局引入实现方法

在项目主文件main.js中引入定义好的实现方法，并注册。

import htmlToPdf from '@/components/utils/htmlToPdf'

使用Vue.use()方法就会调用工具方法中的install方法

Vue.use(htmlToPdf)

4在相关要导出的页面中，点击时调用绑定在Vue原型上的getPdf方法，传入id即可

 html内容部分

<div id="pdfDom">

   <!-- 要下载的HTML页面,页面是由后台返回 -->

  <div v-html="pageData"></div>

</div>

<el-button type="primary" size="small" @click="getPdf('#pdfDom')">点击下载</el-button>

js内容部分

export default {

  data () {

      return {

      htmlTitle: '页面导出PDF文件名'

      }

  }
}

方式二：读取后台返回文件流，利用HTML5中a标签的download属性实现下载

该方法需要先请求后台，后台会返回一个文件流，然后解析文件流，再通过HTML5中<a>标签的download属性实现下载功能。步骤如下：

1发送请求，获取到后台返回的文件流及文件信息

前端发送请求获取下载文件信息：

// 引入下载方法

import {download} from 'utils'

export default{

  methods: {

    async downloadFile () {

      let res = await axios.get(

        url: 'xxxx/xxxx',

        method: 'GET',

        // 设置返回数据类型，这里一定要设置，否则下载下来的pdf会是空白,也可以是`arraybuffer`

        responseType: 'blob',

        params: {

          id: 'xxxxxx'

        }

      )

      // 获取在response headers中返回的下载文件类型

      let type = JSON.parse(res.headers)['content-type']

      

      /*获取在response headers中返回的下载文件名

        因为返回文件名是通过encodeURIComponent()函数进行了编码，因此需要通过decodeURIComponent()函数解码

      */

      let fileName = decodeURIComponent(JSON.parse(res.headers)['file-name'])

      // 调用封装好的下载函数

      download(res, type, fileName)

    }

  }

}

​​​​​​

2封装下载方法 - 解析文件流，创建a标签并设置下载相关属性。

utils.js

export const download = (res, type, filename) => {

  // 创建blob对象，解析流数据

  const blob = new Blob([res], {

    // 如何后端没返回下载文件类型，则需要手动设置：type: 'application/pdf;chartset=UTF-8' 表示下载文档为pdf，如果是word则设置为msword，excel为excel

    type: type

  })

  const a = document.createElement('a')

  // 兼容webkix浏览器，处理webkit浏览器中href自动添加blob前缀，默认在浏览器打开而不是下载

  const URL = window.URL || window.webkitURL

  // 根据解析后的blob对象创建URL 对象

  const herf = URL.createObjectURL(blob)

  // 下载链接

  a.href = herf

  // 下载文件名,如果后端没有返回，可以自己写a.download = '文件.pdf'

  a.download = filename

  document.body.appendChild(a)

  a.click()

  document.body.removeChild(a)

  // 在内存中移除URL 对象

  window.URL.revokeObjectURL(herf)

}

3点击下载按钮，调用下载方法

html内容部分

<div id="pdfDom">

    <!-- 要下载的页面 -->

    <div v-html="pageData"></div>

</div>

<el-button type="primary" size="small" @click="downloadFile">点击下载</el-button>

总结

以上两种实现方式各有优劣，方式一是纯前端实现，需要引入第三方插件，可能会导致项目体积增加。方式二虽然更加简洁，但a标签的download属性为HTML5新增属性，可能存在兼容性问题。如果有需要，可以根据自己情况来选择。