微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

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

1.写在前面

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

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

2.几个备用知识点

2.1. JS触发单击事件

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

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

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

rush:js;"> /** * 触发单击事件 * @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,null); } elem.dispatchEvent(event); }

2.2. HTML5的download属性

这个属性很重要,它可以指定下载文件名,并且可以告诉浏览器目标链接一个下载链接,不是一个普通链接,我们看下面代码就能看出区别了:

rush:js;"> 下载1 下载2

可以发现,下载1按钮能够实现下载,点击下载2链接时直接在浏览器打开文件内容了。

补充说明:

模式下貌似不生效;

链接指向一些第三方链接时也不会生效,具体有待研究;

2.3. JS弹出下载对话框

假如给我们的不是一个下载地址而是一个blob对象,我们可以通过URL.createObjectURL来给blob对象生成临时URL,并且可以利用HTML5的download属性来指定下载的文件名,好家伙,有了这2个东西我们就可以实现一个“万能”的弹出下载对话框方法了。

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

代码如下:

3.JS实现常见文件类型的下载

3.1. JS生成CSV文件并下载

csv是一种逗号分隔的表格文件格式,可以很好的被Excel支持,由于其文件格式简单,所以经常用在简单的表格上面。最重要的是它是一种纯文本格式,可以很轻松地用JS来生成而不借助第三方库。

3.1.1. CSV格式示例

如下:

excel打开效果如下:

3.1.2. 初次尝试

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

以上代码没毛病,然后再换成csv。换csv的最大问题就是如何处理换行,很简单,用encodeURIComponent编码一下就可以了:

rush:js;">

3.1.3. 解决CSV乱码问题

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

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

rush:js;">

3.1.4. 继续解决下载文件名的问题

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

rush:js;"> var csv = '姓名,74'; var blob = new Blob(['\ufeff' + data],{type: 'text/csv,charset=UTF-8'}); openDownloadDialog(blob,'测试.csv');

建议一般情况下都用这种方法,稳妥一点。

3.1.5. 最后总结

不考虑兼容性的保存CSV方法

rush:js;"> /** * 保存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方法

rush:js;"> /** * 保存CSV文件 * @params csv csv文件内容 * @params saveName 保存的文件名 */ function saveCSV(csv,saveName) { var blob = new Blob(['\ufeff' + csv],charset=UTF-8'}); openDownloadDialog(blob,saveName); }

3.2. JS实现纯文本的下载保存

掌握了csv,再去下载纯文本基本上就没啥问题了,就是换一下文件类型而已:

rush:js;"> var csv = '你好,我是小茗同学!\n测试换行!'; var blob = new Blob([data],{type: 'text/txt,'测试.csv');

3.3. JS实现图片的下载保存

网页上一般要保存图片都是从canvas里面拿到的图片数据,通过toDataURL转换为base64数据:

rush:js;"> /** * 将某个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上面有个比较出名的库:

demo:

以上所述是小编给大家介绍的JS实现弹出下载对话框及常见文件类型的下载。编程之家 jb51.cc 收集整理的教程希望能对你有所帮助,如果觉得编程之家不错,可分享给好友!感谢支持

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐