vue项目前端导出word文件(bug解决)

摘要:之前项目中导出价格表是由后端实现,前端只需要调用接口下载word即可,后来业务改变比较大,word模版需要一直改动,后端改起来相对麻烦,后来直接前端自己定义模版,实现下载word文档。

 

一、需要安装的依赖

1、docxtemplater

介绍:docxtemplater是一种邮件合并工具,它以编程方式使用,处理条件、循环,并且可以扩展为表格、HTML、图像等。

安装方法:cnpm i docxtemplater@^3.9.1

2、FileSaver

介绍:FileSaver.js 是在客户端保存文件的解决方案,非常适合需要生成文件,或者保存不应该发送到外部服务器的敏感信息的应用。

安装方法:cnpm i file-saver@^1.3.8

3、jszip

介绍:jszip是一个用于创建、读取和编辑.zip文件的JavaScript库,且API的使用也很简单。

安装方法:cnpm i jszip@^2.6.1

4、jszip-utils

介绍:jszip-utils是与jszip一起使用的跨浏览器的工具库

安装方法:cnpm i jszip-utils@^0.0.2

 

二、创建word模版

介绍:根据自己的业务需求创建需要导出的word模版,变量数据使用{变量名}代替,表格内容数据需要使用{#参数名}开始{/参数名}结尾,具体如下图:

vue项目前端导出word文件(bug解决)

 

注意点:1.模板文件使用vue-cli2的时候,放在static目录下。使用vue-cli3的时候,放在public目录下。

            2.文件须以docx结尾。

不然可能出现的问题:提示Uncaught Error: Corrupted zip: missing 7124 bytes.

vue-cli3示例位置如图:

vue项目前端导出word文件(bug解决)

 

三、html代码编写

定义下载事件downloadprice

<div class="download” @click="downloadprice">下载价格表</div>

 

四、script代码编写

1.使用的页面中导入需要的插件:

import Docxtemplater from 'docxtemplater';
import { saveAs } from 'file-saver';
import JSZip from 'jszip';
import JSZipUtils from 'jszip-utils';

2.定义接口数据(这里为定义好的数据,正常情况下通过接口获取需要在word文档上展示的数据):

data() {
  return {
      // 导出价格表全部信息
    exportPriceObj: {
      actualPayFee: '179.55',
      deliveryFee: '0.00',
      discountActualFee: '179.55',
      discountFee: '9.45',
      discountRatio: '95',
      nickName: '张三',
      retailTotalFee: '0.00',
      totalFee: '189.00',
    },
    // 导出价格表商品信息
    exportPriceListOne: [
      {
        productColor: '白色',
        productName: '0909测试商品',
        productNo: 1,
        productSize: '4XL(58)',
        productSkuId: 'teydnkn',
        sellingPrice: '10.00',
      },
      {
        productColor: '白色',
        productName: '1955测试商品',
        productNo: 2,
        productSize: 'XL(52)',
        productSkuId: 'teydoja',
        sellingPrice: '40.00',
      }
    ],
  }
}

3.下载word文档点击事件方法:

// 下载价格表
downloadprice() {
  let _this = this;
  // 判断有无附加商品来选择word模版
  // 读取并获得模板文件的二进制内容
  JSZipUtils.getBinaryContent('pricenew.docx', function(error, content) {
    console.log('-----', content);
    // input.docx是模板。我们在导出的时候,会根据此模板来导出对应的数据
    // 抛出异常
    if (error) {
      throw error;
    }
    // 创建一个JSZip实例,内容为模板的内容
    let zip = new JSZip(content);
    console.log('+++++', zip);
    // 创建并加载docxtemplater实例对象
    let doc = new Docxtemplater();
    console.log('/////', doc);
    doc.loadZip(zip);
    console.log('=====', doc);
    // 设置模板变量的值
    doc.setData({
      // 导出价格表全部信息
      ..._this.exportPriceObj,
      // 导出价格表商品信息
      tableone: _this.exportPriceListOne,
    });
    try {
      // 用模板变量的值替换所有模板变量
      doc.render();
    } catch (error) {
      // 抛出异常
      let e = {
        message: error.message,
        name: error.name,
        stack: error.stack,
        properties: error.properties
      };
      console.log(JSON.stringify({ error: e }));
      throw error;
    }
    // 生成一个代表docxtemplater对象的zip文件(不是一个真实的文件,而是在内存中的表示)
    let out = doc.getZip().generate({
      type: 'blob',
      mimeType:
        'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
    });
    // 将目标文件对象保存为目标类型的文件,并命名
    saveAs(out, _this.exportPriceObj.nickName + '的价格表.docx');
  });
},

4.点击下载后可能会出现的问题:

一、提示Uncaught Error: Corrupted zip: missing 7124 bytes.

错误方法如图:

vue项目前端导出word文件(bug解决)

可能产生的原因是:1.模版文件word放置的位置获取不到;

                           2.word文档格式出现错误;

解决方法:1.模板文件使用vue-cli2的时候,放在static目录下。使用vue-cli3的时候,放在public目录下。

               2.文件须以docx结尾。

正确方法如图:

vue项目前端导出word文件(bug解决)

 

 

二、提示Uncaught Error: Can't find end of central directory : is this a zip file ?

错误方法如图:

vue项目前端导出word文件(bug解决)

可能产生的原因是:1.你项目里面引用了mockjs文件,它的原理是重写了XMLHttpRequest,导致你上报插件找不到对应的方法;

解决方法:上线时把项目中引入的mock注释掉,// import '@/mock';

原理分析:mockjs是一个模拟后台接口的JS库,它的原理是重写了XMLHttpRequest,它可以在接口没出来时非常方便的模拟数据,上线之后      不引用它即可。一般上报插件中会使用原生XMLHttpRequest,而原生XMLHttpRequest已被mockjs覆盖找不到相应的方法,所以会   出错。除了mockjs之外,zonejs、oboejs、fetchjs也有自己的的XMLHttpRequest库,请慎用。

正确方法如图:

vue项目前端导出word文件(bug解决)

 

五、导出结果

导出结果如图:

vue项目前端导出word文件(bug解决)

有问题欢迎留言,带上问题和代码截图,看到后第一时间回复帮忙解答,谢谢!

 

上一篇:Vue项目纯前端导出word文档


下一篇:【工具箱】egret读取自己的配置文件