一、HTML与文件下载

如果希望在前端侧直接触发某些资源的下载,最方便快捷的方法就是使用HTML5原生的download属性,例如:

  1. <a href="large.jpg" download>下载</a>复制代码

具体介绍可参考我之前的文章:“了解HTML/HTML5中的download属性”。

但显然,如果纯粹利用HTML属性来实现文件的下载(而不是浏览器打开或浏览),对于动态内容,就无能为力。

例如,我们对页面进行分享的时候,希望分享图片是页面内容的实时截图,此时,这个图片就是动态的,纯HTML显然是无法满足我们的需求的,借助JS和其它一些HTML5特性,例如,将页面元素转换到canvas上,然后再转成图片进行下载,可参见“SVG 简介与截图等应用”一文。

但本文要介绍的下载不是图片的下载,而是文本信息的下载,所需要使用的HTML特性不是canvas,而是其它。

二、借助HTML5 Blob实现文本信息文件下载

如果对Blob不了解,可以先看看我好些年之前写的“理解DOMString、Document、FormData、Blob、File、ArrayBuffer数据类型”一文。

原理其实很简单,我们可以将文本或者JS字符串信息借助Blob转换成二进制,然后,作为<a>元素的href属性,配合download属性,实现下载。

代码也比较简单,如下示意(兼容Chrome和Firefox):

  1. var funDownload = function (content, filename) {
  2. // 创建隐藏的可下载链接
  3. var eleLink = document.createElement('a');
  4. eleLink.download = filename;
  5. eleLink.style.display = 'none';
  6. // 字符内容转变成blob地址
  7. var blob = new Blob([content]);
  8. eleLink.href = URL.createObjectURL(blob);
  9. // 触发点击
  10. document.body.appendChild(eleLink);
  11. eleLink.click();
  12. // 然后移除
  13. document.body.removeChild(eleLink);
  14. };复制代码

其中,content指需要下载的文本或字符串内容,filename指下载到系统中的文件名称。

万般言语不达意,一枚实例来走心。

您可以狠狠地点击这里:基于funDownload实现的html格式文件下载demo

点击“下载”按钮,会把文本域中的内容全部作为一个.html后缀文件下载下来,各流程效果如下面几张图:
JS下载各种文本文件、图片(转载) - 图1
出现下载确认框(根据浏览器的设置不同也可能直接下载),然后名称默认就是test.html
JS下载各种文本文件、图片(转载) - 图2
然后对应保存目录就多了个类似下图的文件:
JS下载各种文本文件、图片(转载) - 图3
双击该test.html文件可以在浏览器中正常浏览,说明,保存信息无误。
JS下载各种文本文件、图片(转载) - 图4
触发下载的JS代码就几行:

  1. button.addEventListener('click', function () {
  2. funDownload(textarea.value, 'test.html');
  3. });复制代码

三、借助Base64实现任意文件下载

对于非文本文件,也是可以直接JS触发下载的,例如,如果我们想下载一张图片,可以把这张图片转换成base64格式,然后下载。

代码示意:

  1. var funDownload = function (domImg, filename) {
  2. // 创建隐藏的可下载链接
  3. var eleLink = document.createElement('a');
  4. eleLink.download = filename;
  5. eleLink.style.display = 'none';
  6. // 图片转base64地址
  7. var canvas = document.createElement('canvas');
  8. var context = canvas.getContext('2d');
  9. var width = domImg.natureWidth;
  10. var height = domImg.natureHeight;
  11. context.drawImage(domImg, 0, 0);
  12. // 如果是PNG图片,则canvas.toDataURL('image/png')
  13. eleLink.href = canvas.toDataURL('image/jpeg');
  14. // 触发点击
  15. document.body.appendChild(eleLink);
  16. eleLink.click();
  17. // 然后移除
  18. document.body.removeChild(eleLink);
  19. };
  20. 作者:张鑫旭
  21. 链接:https://juejin.im/post/5bd1b0aa6fb9a05d2c43f004
  22. 来源:掘金
  23. 著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

四、结束语

不止是.html文件,.txt, .json等文本文件都可以使用这种小技巧实现下载。

在Chrome浏览器下,模拟点击创建的<a>元素即使不append到页面中,也是可以触发下载的,但是在Firefox浏览器中却不行,因此,上面的funDownload()方法有一个appendChildremoveChild的处理,就是为了兼容Firefox浏览器。

download属性从Edge13开始支持,根据同行测试可以触发下载,不过生成的文件命名类似GUID,需要手动再加个后缀。