纯前端JS zip打包文件并下载

这篇文章发布于 2019年08月17日,星期六,22:49,归类于 JS实例。 阅读 92883 次, 今日 19 次 14 条评论

 

zip压缩与下载

一、事情的起因

之前做了个SVG Sprites还原工具(上传合并好的SVG Sprites文件,分解成独立的小SVG),然后经用户反馈,希望增加个打包下载功能。

然后我就研究了下,还挺有意思的,目前已经上线,如下图所示:

ZIP打包下载示意

然后就可以下载了,下面是找到的下载记录。

下载记录

二、如何实现ZIP打包下载

使用jszip这个项目实现的:https://github.com/Stuk/jszip

压缩和未压缩的JS文件都在dist目录下,大家自行下载。

使用也非常简单:

  1. 引入JS
    <script src="./jszip.min.js"></script>
  2. 执行打包与下载

    下面是官方示意代码,我加上了更详细的注释:

    // 初始化一个zip打包对象
    var zip = new JSZip();
    // 创建一个被用来打包的名为Hello.txt的文件
    zip.file("Hello.txt", "Hello World\n");
    // 创建一个名为images的新的文件目录
    var img = zip.folder("images");
    // 这个images文件目录中创建一个base64数据为imgData的图像,图像名是smile.gif
    img.file("smile.gif", imgData, {base64: true});
    // 把打包内容异步转成blob二进制格式
    zip.generateAsync({type:"blob"}).then(function(content) {
        // content就是blob数据,这里以example.zip名称下载    
        // 使用了FileSaver.js  
        saveAs(content, "example.zip");
    });
    
    /*
    最终下载的zip文件包含内容如下:
    Hello.txt
    images/
        smile.gif
    */

使用非常简单,官方示意也通俗易懂,我直接照着改改效果就出来了。

其中,提到了一个FileSaver.js,这也是非常有名的项目,可以介绍一下。

三、纯前端下载FileSaver.js

FileSaver.js项目地址是:https://github.com/eligrey/FileSaver.js/

压缩和未压缩的JS文件也是在dist目录下,大家自行下载。

使用示意:

<script src="./FileSaver.min.js"></script>
<script>
var canvas = document.getElementById("zxx-canvas");
canvas.toBlob(function(blob) {
    saveAs(blob, "example.png");
});
</script>

FileSaver.js非常强,不仅兼容到IE10+,而且还支持大文件下载,Chrome浏览器下甚至可以下载2GB大小的文件。

FileSaver.js搭配js-xlsx还可以纯前端下载Excel文件。如果是生成DOC文件,试试这个项目

由于非本文重点,不展开。

另外,纯前端下载方法还有很多。有兴趣可以参考这篇文章:“这应该是你见过的最全前端下载总结”。

四、我的jszip使用示意

我的需求是把一堆SVG文件打包下载,已经有SVG代码和id数据(可以作为文件名)。

由于我的下载功能不需要兼容IE浏览器,因此,直接使用了<a>元素下载,基于HTML5 download属性

于是有如下代码:

// data是个数组
// 数组项结构 {id: "icon-xxx", svgHTML: "<svg>..."}
var zip = new JSZip();
data.forEach(function (obj) {
  // zip包里面不断塞svg文件
  zip.file(obj.id + '.svg', obj.svgHTML);
});
// 生成zip文件并下载
zip.generateAsync({ 
  type: 'blob'
}).then(function(content) {
  // 下载的文件名
  var filename = key + '.zip';
  // 创建隐藏的可下载链接
  var eleLink = document.createElement('a');
  eleLink.download = filename;
  eleLink.style.display = 'none';
  // 下载内容转变成blob地址
  eleLink.href = URL.createObjectURL(content);
  // 触发点击
  document.body.appendChild(eleLink);
  eleLink.click();
  // 然后移除
  document.body.removeChild(eleLink);
});

五、快速结语

以后估计还会遇到类似的需求,所以自己整理了篇tips记录下,顺便记录点其他下载相关的内容。

也希望顺便可以帮到其他类似需求的小伙伴。

(本篇完)

分享到:


发表评论(目前14 条评论)

  1. AICC说道:

    a标签的下载在移动端浏览器上,不支持blob和base64的数据

  2. 提建议说道:

    这就很有意思了,js的zip打包百度来的远不都是zip等插件使用,为什么都没有原生方法 或者原理之类的讲解

  3. 明天说道:

    跨域能解决吗

  4. koizora说道:

    在使用最新的FileSaver.js的时候,chrome浏览器导出的文件没有文件名,是什么问题,火狐是可以的

    • koizora说道:

      更正一下是chrome浏览器导出的时候没有后缀名,有没有童鞋遇到过怎么解决的?

  5. zhiwenxuan说道:

    楼主有解决多个大文件的打包压缩吗?比如 1GB 以上,会变得比较慢。

  6. 萌新小俊说道:

    zip.folder(“中文目录名乱码”);楼主怎么解决的

  7. gxlself说道:

    这个就有意思了,感谢张大大分享

  8. ferrinweb说道:

    document.body.appendChild(eleLink);
    这一行是多余的,并不需要这个操作。同样,反操作也是。