[聚合文章] 使用JavaScript将图片保存至本地

HTML5 2018-01-03 23 阅读

在最近的开发当中,我们需要为img标签以及canvas动态绘制的图像提供下载功能,下面是经过探索后我们得出的结果。

一、Canvas 版本

// 下载Canvas元素的图片function downloadCanvasIamge(selector, name) {    // 通过选择器获取canvas元素    var canvas = document.querySelector(selector)    // 使用toDataURL方法将图像转换被base64编码的URL字符串    var url = canvas.toDataURL('image/png')    // 生成一个a元素    var a = document.createElement('a')    // 创建一个单击事件    var event = new MouseEvent('click')        // 将a的download属性设置为我们想要下载的图片名称,若name不存在则使用‘下载图片名称’作为默认名称    a.download = name || '下载图片名称'    // 将生成的URL设置为a.href属性    a.href = url        // 触发a的单击事件    a.dispatchEvent(event)}// 调用方式// 参数一: 选择器,代表canvas// 参数二: 图片名称,可选downloadCanvasIamge('canvas', '图片名称')

二、img 标签版本

// 下载function downloadIamge(selector, name) {    // 通过选择器获取img元素    var img = document.querySelector(selector)    // 将图片的src属性作为URL地址    var url = img.src    var a = document.createElement('a')    var event = new MouseEvent('click')        a.download = name || '下载图片名称'    a.href = url        a.dispatchEvent(event)}// 调用方式// 参数一: 选择器,代表canvas// 参数二: 图片名称,可选downloadIamge('canvas', '图片名称')

三、总结

我们主要使用的是a标签的download属性, 下面为MDN给出的说明:

此属性指示浏览器下载URL而不是导航到URL,因此将提示用户将其保存为本地文件。
如果属性有一个值,它将在保存提示中用作预先填写的文件名 (用户仍然可以根据需要更改文件名)。对允许的值没有限制,但是/和\被转换为下划线。大多数文件系统限制文件名中的一些标点符号,浏览器会相应地调整建议的名称。

需要注意的地方:

  • 此属性仅适用于同源 URLs。
  • 可以使用 blob: URLs 和 data: URLs 以方便用户下载 JavaScript 方式生成的内容(例如使用在线绘图的Web应用创建的照片)。
  • 如果HTTP头的Content-Disposition:存在,并且赋予了一个和这个属性不同的文件名,HTTP头优先于此属性。
  • 如果这个属性存在 Content-Disposition 被设置为 inline,火狐优先 Content-Disposition,像之前文件名​​的情况下,而Chrome则优先 download 属性。

参考地址: