Vue頁面生成PDF的最佳方法推薦

更新時(shí)間：2022年05月24日 10:04:35 作者：憤怒小綿羊

公眾中經(jīng)常會有這種場景,一些合同、協(xié)議等的頁面需要進(jìn)行下載,而且需要和頁面保持一致,下面這篇文章主要給大家介紹了關(guān)于Vue頁面生成PDF的最佳方法,需要的朋友可以參考下

前言

最近項(xiàng)目有個(gè)需求，將系統(tǒng)統(tǒng)計(jì)的數(shù)據(jù)生成分析報(bào)告，然后可以導(dǎo)出成PDF。

這種方法可以有兩種，一種是直接調(diào)用打印，用戶通過瀏覽器提供的打印頁面手動選擇導(dǎo)出PDF。當(dāng)然這種方式兼容性差，且體驗(yàn)不好，顯然不是我們想要的效果。

那么第二種方法的實(shí)現(xiàn)思路是什么呢？

首先生成報(bào)告頁面，也就是常規(guī)頁面；

然后將頁面轉(zhuǎn)換成圖片（用到的組件 html2canvas ）；

最后將圖片導(dǎo)出成PDF（用到的組件 jspdf ）。

安裝依賴

npm install --save html2canvas  // 頁面轉(zhuǎn)圖片
npm install jspdf --save  // 圖片轉(zhuǎn)pdf

頁面轉(zhuǎn)圖片

新建一個(gè) index.vue 頁面：

<template>
  <div ref="pdf">
    這是待轉(zhuǎn)換的頁面，點(diǎn)擊 
    <button @click="handleExport">導(dǎo)出</button> 按鈕，完成導(dǎo)出操作。
  </div>
</template>

<script>
import {downloadPDF} from "@/util/pdf.js"  //工具方法，導(dǎo)出操作
export default {
  name: "pdf",
  data() {
    return {};
  },
  methods: {
    handleExport(){
      downloadPDF(this.$refs.pdf)
    }
  }
};
</script>

頁面很簡單，一段話加上一個(gè)導(dǎo)出按鈕。整個(gè)頁面被設(shè)置別名（ref=“pdf”），導(dǎo)出的時(shí)候通過別名導(dǎo)出整個(gè)頁面。

按鈕點(diǎn)擊事件中調(diào)用了一個(gè)工具方法 downloadPDF()，來自于工具類 pdf.js：

import html2canvas from "html2canvas";

export const downloadPDF = page => {
  html2canvas(page).then(function(canvas) {
    page.appendChild(canvas);
  });
};

也很簡單，首先引入了 html2canvas，定義downloadPDF方法，接受一個(gè)參數(shù)就是要導(dǎo)出的內(nèi)容，可以使用id獲取，也可以使用 ref 。

運(yùn)行結(jié)果：

當(dāng)我們點(diǎn)擊導(dǎo)出按鈕后，在現(xiàn)有的頁面增加了一行相同的內(nèi)容。通過元素檢查器可以看到增加的這行內(nèi)容實(shí)際是一個(gè) canvas 圖像，里面的按鈕已經(jīng)不可以操作了。

這樣，頁面轉(zhuǎn)換圖片的過程就完成了。

圖片轉(zhuǎn)PDF

首先給index.vue改造一下，為了讓我們導(dǎo)出的pdf好看一點(diǎn)，使用el-table做個(gè)表格，其它的導(dǎo)出邏輯不變：

<template>
  <div ref="pdf">
    
    <el-table
      :data="tableData"
      style="width: 700px">
      <el-table-column
        prop="date"
        label="時(shí)間"
        width="180">
      </el-table-column>
      <el-table-column
        prop="name"
        label="姓名"
        width="180">
      </el-table-column>
      <el-table-column
        prop="address"
        label="對我說">
      </el-table-column>
    </el-table>

    <button @click="handleExport">導(dǎo)出</button>
  </div>
</template>
<script>
import {downloadPDF} from "@/util/pdf.js"  //工具方法，導(dǎo)出操作
export default {
  name: "pdf",
  data() {
    return {
      
          tableData: [{
            date: '昨天',
            name: '劉德華',
            address: '你好帥'
          }, {
            date: '今天',
            name: '郭富城',
            address: '你最帥'
          }, {
            date: '明天',
            name: '張學(xué)友',
            address: '你賊帥'
          }, {
            date: '每天',
            name: '黎明',
            address: '我沒你帥'
          }]
    };
  },
  methods: {
    handleExport(){
      downloadPDF(this.$refs.pdf)
    }
  }
};
</script>

效果圖：

然后改造一下pdf.js，增加上pdf轉(zhuǎn)換邏輯

import html2canvas from "html2canvas";
import jsPDF from "jspdf";

export const downloadPDF = page => {
  html2canvas(page).then(function(canvas) {
    canvas2PDF(canvas);
  });
};

const canvas2PDF = canvas => {
  let contentWidth = canvas.width;
  let contentHeight = canvas.height;
  
  let imgHeight = contentHeight;
  let imgWidth = contentWidth;

  // 第一個(gè)參數(shù)： l：橫向  p：縱向
  // 第二個(gè)參數(shù)：測量單位（"pt"，"mm", "cm", "m", "in" or "px"）
  let pdf = new jsPDF("l", "pt");

  pdf.addImage(
    canvas.toDataURL("image/jpeg", 1.0),
    "JPEG",
    0,
    0,
    imgWidth,
    imgHeight
  );

  pdf.save("導(dǎo)出.pdf");
};

canvas2PDF 方法中創(chuàng)建了jsPDF的實(shí)例，然后添加上一步生成的圖片，最后保存導(dǎo)出pdf文件。

導(dǎo)出的文件效果：

A4打印適配

因?yàn)椴糠中枨笥行枰傻捻撁媸褂肁4紙打印，那么pdf生成時(shí)的寬高尺寸就不能像上面一樣設(shè)定。需要按照A4紙的尺寸比例調(diào)整（其它打印需求同理，使用對應(yīng)紙張比例即可）

那么改造一下 pdf.js

import html2canvas from "html2canvas";
import jsPDF from "jspdf";

export const downloadPDF = page => {
  html2canvas(page).then(function(canvas) {
    canvas2PDF(canvas);
  });
};

const canvas2PDF = canvas => {
  let contentWidth = canvas.width;
  let contentHeight = canvas.height;

  //a4紙的尺寸[595.28,841.89]，html頁面生成的canvas在pdf中圖片的寬高
  let imgWidth = 595.28;
  let imgHeight = 592.28/contentWidth * contentHeight;

  // 第一個(gè)參數(shù)： l：橫向  p：縱向
  // 第二個(gè)參數(shù)：測量單位（"pt"，"mm", "cm", "m", "in" or "px"）
  let pdf = new jsPDF("p", "pt");

  pdf.addImage(
    canvas.toDataURL("image/jpeg", 1.0),
    "JPEG",
    0,
    0,
    imgWidth,
    imgHeight
  );

  pdf.save("導(dǎo)出.pdf");
};

這里面將 imgWidth 和 imgHeight 按照A4紙比例調(diào)整后，導(dǎo)出的pdf就可以正常比例打印了。