文档章节

JS弹出下载对话框以及实现常见文件类型的下载

_多么痛的领悟
 _多么痛的领悟
发布于 01/16 16:09
字数 1667
阅读 8
收藏 0

JS弹出下载对话框以及实现常见文件类型的下载 本文由 小茗同学 发表于 2017-02-16 浏览(1200) 最后修改 2018-01-15 标签:javascript saveas 下载 对话框

写在前面 JS要实现下载功能,一般都是这么几个过程:生成下载的URL,动态创建一个A标签,并将其href指向生成的URL,然后触发A标签的单击事件,这样就会弹出下载对话框,从而实现了一个下载的功能。

这里所说的下载,有时候也可以理解为保存。出于安全考虑,JS肯定无法直接调用FileAPI写文件到磁盘,但是却可以通过下载来变相实现保存功能。

几个备用知识点 2.1. JS触发单击事件 既然是用A标签模拟,那么肯定要知道JS如何主动触发单击事件。

最简单的触发单击事件肯定是elem.click(),平时在不需要考虑兼容性的场合我都是这么干的,但是毕竟这个方法有兼容性(具体兼容性如何没做过测试),所以还是要掌握一个通用的方法。

以下代码是网上比较容易找到的一段代码,我在前面加了一段MouseEvent的判断:

/**

  • 考虑兼容性的触发单击事件
  • @param elem 要触发单击事件的DOM对象 */ function fireClickEvent(elem) { var event; if(window.MouseEvent) event = new MouseEvent('click'); else { event = document.createEvent('MouseEvents'); event.initMouseEvent('click', true, false, window, 0, 0, 0, 0, 0, false, false, false, false, 0, null); } elem.dispatchEvent(event); } 2.2. HTML5的download属性 这个属性很重要,它可以指定下载文件名,并且可以告诉浏览器目标链接是一个下载链接,不是一个普通链接,我们看下面代码就能看出区别了:

<a href="data:text/txt;charset=utf-8,测试下载纯文本" download="测试.txt" >下载1</a> <a href="data:text/txt;charset=utf-8,测试下载纯文本">下载2</a> 可以发现,下载1按钮能够实现下载,点击下载2链接时直接在浏览器打开文件内容了。

补充说明:

file:///模式下貌似不生效; 链接指向一些第三方链接时也不会生效,具体有待研究; 2.3. JS弹出下载对话框 假如给我们的不是一个下载地址而是一个blob对象,我们可以通过URL.createObjectURL来给blob对象生成临时URL,并且可以利用HTML5的download属性来指定下载的文件名,好家伙,有了这2个东西我们就可以实现一个“万能”的弹出下载对话框方法了。

综上所述,我又在fireClickEvent的基础上继续简单封装了一个openDownloadDialog方法,使用如下:

openDownloadDialog(url, saveName) openDownloadDialog(blob, saveName) 代码如下:

/**

  • 通用的打开下载对话框方法,没有测试过具体兼容性
  • @param url 下载地址,也可以是一个blob对象,必选
  • @param saveName 保存文件名,可选 */ function openDownloadDialog(url, saveName) { if(typeof url == 'object' && url instanceof Blob) { url = URL.createObjectURL(url); // 创建blob地址 } var aLink = document.createElement('a'); aLink.href = url; aLink.download = saveName || ''; // HTML5新增的属性,指定保存文件名,可以不要后缀,注意,file:///模式下不会生效 var event; if(window.MouseEvent) event = new MouseEvent('click'); else { event = document.createEvent('MouseEvents'); event.initMouseEvent('click', true, false, window, 0, 0, 0, 0, 0, false, false, false, false, 0, null); } aLink.dispatchEvent(event); } JS实现常见文件类型的下载 3.1. JS生成CSV文件并下载 csv是一种逗号分隔的表格文件格式,可以很好的被Excel支持,由于其文件格式简单,所以经常用在简单的表格上面。最重要的是它是一种纯文本格式,可以很轻松地用JS来生成而不借助第三方库。

3.1.1. CSV格式示例 如下:

姓名,期中成绩,期末成绩 张三,58,95 李四,98,74 王二,47,38 刘能,15,100 黄五,87,68 excel打开效果如下:

3.1.2. 初次尝试 首先想到的是使用data:text/txt;来实现,先看一下下载纯文本:

<a download="测试.txt" href="data:text/txt;charset=utf-8,测试下载纯文本">下载</a> 以上代码没毛病,然后再换成csv。换csv的最大问题就是如何处理换行,很简单,用encodeURIComponent编码一下就可以了:

<button onclick="test()">下载CSV</button>

<script> function test() { var csv = '姓名,期中成绩,期末成绩\n张三,58,95\n李四,98,74'; var a = document.createElement('a'); a.href = 'data:text/txt;charset=utf-8,'+encodeURIComponent(csv); a.download = '测试.csv'; a.click(); // 这里偷个懒,直接用click模拟 } </script>

3.1.3. 解决CSV乱码问题 虽然我们用的是UTF-8编码,下载后你会发现,用文本编辑器打开没问题,但是用Excel打开乱码:

别急,原因就是少了一个\ufeffBOM头,改成这样就没问题了:

<button onclick="test()">下载CSV</button>

<script> function test() { var csv = '姓名,期中成绩,期末成绩\n张三,58,95\n李四,98,74'; var a = document.createElement('a'); a.href = 'data:text/txt;charset=utf-8,\ufeff'+encodeURIComponent(csv); a.download = '测试.csv'; a.click(); // 这里偷个懒,直接用click模拟 } </script>

3.1.4. 继续解决下载文件名的问题 大部分浏览器可能都没啥问题,但是一些比较老的Chrome可能下载的时候指定的download就是不生效,此时可以用blob来解决:

var csv = '姓名,期中成绩,期末成绩\n张三,58,95\n李四,98,74'; var blob = new Blob(['\ufeff' + data], {type: 'text/csv,charset=UTF-8'}); openDownloadDialog(blob, '测试.csv'); 建议一般情况下都用这种方法,稳妥一点。

3.1.5. 最后总结 不考虑兼容性的保存CSV方法:

/**

  • 保存CSV文件
  • @params csv csv文件内容
  • @params saveName 保存的文件名 */ function saveCSV(csv, saveName) { var a = document.createElement('a'); a.href = 'data:text/csv;charset=utf-8,\ufeff' + encodeURIComponent(csv); a.download = saveName; a.click(); } 考虑兼容性的保存CSV方法:

/**

  • 保存CSV文件
  • @params csv csv文件内容
  • @params saveName 保存的文件名 */ function saveCSV(csv, saveName) { var blob = new Blob(['\ufeff' + csv], {type: 'text/csv,charset=UTF-8'}); openDownloadDialog(blob, saveName); } 3.1.6. 20180115更新 今天碰到了一个CSV文件太长导致下载失败的问题(有1.6MB),如下图:

经测试发现,直接采用拼接字符串的方法对于太大的csv文件可能会下载失败,换成blob对象就不会,所以,建议无论何时都采用blob方法最稳妥。

3.2. JS实现纯文本的下载保存 掌握了csv,再去下载纯文本基本上就没啥问题了,就是换一下文件类型而已:

var csv = '你好,我是小茗同学!\n测试换行!'; var blob = new Blob([data], {type: 'text/txt,charset=UTF-8'}); openDownloadDialog(blob, '测试.csv'); 3.3. JS实现图片的下载保存 网页上一般要保存图片都是从canvas里面拿到的图片数据,通过toDataURL转换为base64数据:

/**

  • 将某个canvas保存为图片
  • @param canvasObj canvas对象
  • @param saveName 保存的名称
  • @param type 保存的图片格式,如 image/png
  • @param quality 图片质量,可选0-1 / function saveImage(canvasObj, saveName, type, quality) { if(!canvasObj) return; type = type || 'image/png'; quality = quality || 0.92; var url = canvasObj.toDataURL(type, quality).replace(/image/.?;/, 'image/octet-stream;'); openDownloadDialog(url, saveName); } 拓展 关于文件保存,不嫌麻烦的话,GitHub上面有个比较出名的库:https://github.com/eligrey/FileSaver.js/ demo:https://eligrey.com/demos/FileSaver.js/

本文转载自:http://blog.haoji.me/js-download.html

共有 人打赏支持
_多么痛的领悟
粉丝 0
博文 64
码字总数 10258
作品 0
延庆
程序员
私信 提问
爬虫获取 js 动态数据 (万方数据库文献下载)

今天讲讲用爬虫下载万方数据库文献。 这是我们要爬取的文献链接: http://www.wanfangdata.com.cn/details/detail.do?_type=perio&id=zgtx201803009 右键那个下载按钮 -> 检查,我们可以看见,...

anye137
06/07
0
0
JavaScript语言基础-环境搭建

我们要想编写和运行JavaScript脚本,则需要:JavaScript编辑工具和JavaScript运行测试环境。下面我们分别介绍一下。 JavaScript编辑工具 JavaScript编辑工具最简单的可以使用一些文本编辑工具...

智捷课堂
2015/03/12
0
0
关于RunJS你不知道的几个事情

关于RunJS,一直没有一个好的教程或者文档来说明怎么使用,当然基本的使用就是编辑html、css、js代码并发布分享了。这里我要列出一些关于RunJS你不知道的几个tip。 收起左边栏:大家可以点击...

王振威
2012/11/12
5.1K
10
搭建Cocos2d-JS开发环境

使用Cocos2d-JS引擎开发游戏,主要的程序代码是JavaScript语言,因此,凡是能够开发JavaScript语言工具都适用于Cocos2d-JS游戏开发。本书我们推荐WebStorm和Cocos Code IDE工具。 搭建WebSt...

智捷课堂
2015/03/18
0
0
eclipse安装Spket插件

首先需要安装Spket。 网上下载spket-1.6.16.jar破解版(目前最新版本) 1.如果你的JDK在1.6以上,可以直接双击 spket-1.6.16.jar运行安装。 其它,使用命令行方式。(注意:自己切换命令行到...

柒月-小妖精
2013/01/07
0
0

没有更多内容

加载失败,请刷新页面

加载更多

jquery通过id显示隐藏

var $div3 = $('#div3'); 显示 $div3.show(); 隐藏 $div3.hide();

yan_liu
今天
3
0
《乱世佳人》读书笔记及相关感悟3900字

《乱世佳人》读书笔记及相关感悟3900字: 之前一直听「荔枝」,后来不知怎的转向了「喜马拉雅」,一听就是三年。上班的时候听房产,买房了以后听装修,兴之所至时听旅行,分手后听亲密关系,...

原创小博客
今天
3
0
大数据教程(9.6)map端join实现

上一篇文章讲了mapreduce配合实现join,本节博主将讲述在map端的join实现; 一、需求 实现两个“表”的join操作,其中一个表数据量小,一个表很大,这种场景在实际中非常常见,比如“订单日志...

em_aaron
今天
3
0
cookie与session详解

session与cookie是什么? session与cookie属于一种会话控制技术.常用在身份识别,登录验证,数据传输等.举个例子,就像我们去超市买东西结账的时候,我们要拿出我们的会员卡才会获取优惠.这时...

士兵7
今天
3
0
十万个为什么之为什么大家都说dubbo

Dubbo是什么? 使用背景 dubbo为什么这么流行, 为什么大家都这么喜欢用dubbo; 通过了解分布式开发了解到, 为适应访问量暴增,业务拆分后, 子应用部署在多台服务器上,而多台服务器通过可以通过d...

尾生
今天
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部