如何优雅使用 vue-html2pdf 插件生成pdf报表

使用 vue-html2pdf 插件

业务背景，老板想要一份能征服客户的pdf报表，传统的pdf要手撕，企业中确实有点耗费时间，于是github上面看到开源的这个插件就…废话不多说，直接上教程

1.使用下面命令安装 vue-html2pdf

npm i vue-html2pdf

2.在vue组件下使用

<template>
   <div>
       <!-- 具体说明看文档 -->
       <vue-html2pdf
   	      :show-layout="false"
   	      :float-layout="true"
   	      :enable-download="true"
   	      :preview-modal="true"
   	      :paginate-elements-by-height="1400"
   	      :filename="fileName"
   	      :pdf-quality="2"
   	      :manual-pagination="false"
   	      pdf-format="a4"
   	      pdf-orientation="portrait"
   	      pdf-content-width="800px"
   	      @progress="onProgress($event)"
   	      @hasStartedGeneration="hasStartedGeneration()"
   	      @rendered="hasGenerated($event)"
   	      ref="html2Pdf"
       >
           <section slot="pdf-content">
               <!-- 这里写要生成PDF的元素 -->
                           <section class="pdf-item">
                               <span>
                                   <div class="wrapper">
                                       <div class="header">
                                       <div class="main">
                                       <div class="footer">
                               </span>
                           </section>
                           <div class="html2pdf__page-break"/> //分页
                           ...有几页就再写一个pdf-item就好了
           </section>
       </vue-html2pdf>
   </div>
</template>
//引入vue-html2pdf
import VueHtml2pdf from "vue-html2pdf";
export default {
   components: {
       //注册组件
       VueHtml2pdf
   },
   methods: {
       //声明下载为PDF的方法
       generateReport () {
           this.$refs.html2Pdf.generatePdf()
       }
   },
}

另外我加了进度条，看到有这个加载的属性，就顺便封装了个进度条，看起来更优雅一点。默认值我设置的1，这个看自己调整。废话不说，直接上代码（Progress.vue），在项目中直接引用即可

<template>
  <div class="m-progress" :style="`width:${width}px;`">
    <div class="m-progress-outer">
      <div class="m-progress-inner">
        <div :class="['u-progress-bg', {'u-success-bg': progress >= 100}]" :style="`width: ${progress >= 100 ? 100:progress}%; height: ${strokeWidth}px;`"></div>
      </div>
    </div>
    <template v-if="showInfo"></template>
    <svg class="u-success" v-if="progress>=100" viewBox="64 64 896 896" data-icon="check-circle" aria-hidden="true" focusable="false">
      <path d="M512 64C264.6 64 64 264.6 64 512s200.6 448 448 448 448-200.6 448-448S759.4 64 512 64zm193.5 301.7l-210.6 292a31.8 31.8 0 0 1-51.7 0L318.5 484.9c-3.8-5.3 0-12.7 6.5-12.7h46.9c10.2 0 19.9 4.9 25.9 13.3l71.2 98.8 157.2-218c6-8.3 15.6-13.3 25.9-13.3H699c6.5 0 10.3 7.4 6.5 12.7z"></path></svg>
    <p class="u-progress-text" v-else>{{ progress>=100 ? 100:progress }}%</p>
  </div>
</template>
<script>
export default {
  name: 'Progress',
  props: {
    width: { // 进度条总宽度
      type: Number,
      default: 600
    },
    progress: { // 当前进度
      type: Number,
      default: 1
    },
    strokeWidth: { // 进度条线的宽度
      type: Number,
      default: 8
    },
    showInfo: { // 是否显示进度数值或状态图标
      type: Boolean,
      default: true
    }
  }
}
</script>
<style lang="scss" scoped="scoped">
.m-progress {
  height: 24px;
  margin: 0 auto;
  display: flex;
  .m-progress-outer {
    width: 100%;
    .m-progress-inner {
      display: inline-block;
      width: 100%;
      background: #f5f5f5;
      border-radius: 100px;
      .u-progress-bg {
        // background: #1890FF;
        background: linear-gradient(to right, rgb(16, 142, 233), rgb(135, 208, 104));
        border-radius: 100px;
        transition: all .3s cubic-bezier(.08,.82,.17,1);
      }
      .u-success-bg {
        background: #52C41A;
      }
    }
  }
  .u-success {
    width: 16px;
    height: 16px;
    fill: #52C41A;
    margin-left: 8px;
    margin-top: 4px;
  }
  .u-progress-text {
    font-size: 16px;
    line-height: 24px;
    margin-left: 8px;
    color: rgba(0,0,0,.45);
  }
}
</style>

3.属性整理一下

属性	值	描述	本人建议
show-layout	true/false	是否显示要转为 PDF 的元素	调式要转出的元素的布局时 true，平时 false
float-layout	true/false	如果道具设置为 false 道具 show-layout 将被覆盖。布局不会浮动，并且布局将始终显示。	我一直使用的 true，因为做的时候做了两份，一个是在后台显示的，一个是导出为 PDF 的，布局不一样
enable-download	true/false	是否弹出转 PDF 后的预览模板，为 true 时调用上面的下载方法默认弹出预览模板	调试时开启，完工后关闭
preview-modal	true/false	是否弹出转 PDF 后的预览模板，为 true 时调用上面的下载方法默认弹出预览模板	调试时开启，完工后关闭
paginate-elements-by-height	任何数字	输入的数字将用于对元素进行分页，数字仅以 px 为单位。	官方默认 1400，没动过
filename	任何字符串	导出后的默认 PDF 文件名	自定义
pdf-quality	0 - 2（可以有小数）	2 是最高质量，0.1 是最低质量，0 将使 PDF 消失。	官方虽然说是 0~2，但是我调 5 也是更高清了
manual-pagination	true/false	为 true 时不会自动对元素进行分页。为 false 时分页将依赖于具有“html2pdf__page-break”类的元素来知道在哪里分页，也就是下面所写的	我一直使用的 false，看需求
pdf-format	a0, a1, a2, a3, a4, letter, legal, a5, a6, a7, a8, a9, a10	这是 PDF 格式（纸张尺寸）	一般都用的a4，所以 a4
pdf-orientation	portrait, landscape	PDF 方向，landscape 是横向，portrait 是纵向	看需求
pdf-content-width	任何 css 尺寸（例如“800px”、“65vw”、“70%”）	PDF 内容宽度	800px 应该是 a4 最大的尺寸，具体边距我使用的 padding

4.说到分页这个，组件中有自动分页，但是会影响你的页眉页脚，如果不想自动分页的话，直接在元素后面加上下面代码即可分页

5.个人使用感想：使用这个插件后，渲染的话还可以的直接和vue能搭配，更能和E-Charts搭配使用，确实方便，优点：节约开发成本，提高开发效率，拿来即用。缺点：不支持超链接功能，有时候业务场景需要在pdf中超链接，如果有这个功能的话，那就很全了。当然，也不是说这个组件不好，使用起来还是比较丝滑的。主要是看业务场景吧。
6. 项目中遇到比较棘手的问题，就是动态排版展示，因为本人是后端，所以跟专业前端大佬不能比，就想记录一下

本身是想写死多少个平台，然后使用v-if或者v-show来展示，但是代码量有点冗余不说，还没有排版好，就想到了v-for。

					<div class="b1" style="width: 100%; display: flex; flex-wrap: wrap;">
                      <div v-for="(platform, index) in platforms"
                           :key="index" v-if="platform.count > 0"
                           class="bordered3"
                           style="flex-basis: calc(50% - 10px); margin-right: 10px; margin-bottom: 10px;">
                        <div class="r3">
                          <p class="p1">{{ platform.instituteType }}处理违规数量</p>
                          <span class="p2">{{ platform.count }}</span>
                        </div>
                        <div class="r4">
                          <img class="tb"
                               :src="getPlatformImage(platform.instituteType)"
                               alt="Sample Image">
                        </div>
                      </div>
                    </div>

v-for主要没啥，主要是动态样式调整起来确实费事，终于能体会到前端大佬的不易！觉得好玩的可以去试试！