将 Canvas 保存为图片并下载至本地
在实际开发过程中,有时需要将图表或者者地图等基于Canvas技术渲染的数据下载到本地保存到情况,下面详情两种方法来完成这种功能。
一、a 标签法
a 标签方法主要分为以下步骤:
- 将 canvas 元素的数据通过原生 api 转换成 base64 编码的图片格式
- 利用 a 标签设置 download 属性可以将 href 链接元素下载,我们将 a 标签的 href 属性值设置为上一步取得的 base64 格式字符串
- 构造一个单击事件并通过 api 触发 a 标签的 click 事件完成下载
注意点:因为浏览器安全限制,事件触发的代码不能被异步代码包裹
以下为代码示例:
index.html
<!-- 待下载对 canvas 元素 --><!-- 手机端可能会因为 viewport 的起因导致下载的图片不清晰,我们可以在 canvas 标签上直接设置 width 和 height 属性,不采用 style 中的 width 和 height, 相当于设置内部分辨率 --><canvas id="chart" width="1920" height="1080"></canvas><!-- 触发下载操作的按钮 --><button onclick="download('#chart')">下载</button>download.js
function download(selector) { // 通过 API 获取目标 canvas 元素 const canvas = document.querySelector(selector); // 创立一个 a 标签,并设置 href 和 download 属性 const el = document.createElement('a'); // 设置 href 为图片经过 base64 编码后的字符串,默认为 png 格式 el.href = canvas.toDataURL(); el.download = '文件名称'; // 创立一个点击事件并对 a 标签进行触发 const event = new MouseEvent('click'); el.dispatchEvent(event);}下面我们总结下 a 标签法的优缺点:
- 优点:只使用浏览器提供的原生 API 就能实现我们的需求。
- 缺点:无法被异步代码包裹,也就是包含 Ajax 请求的情况下代码不生效。
- 缺点:对于分辨率过高的 canvas, 我们生成的 dataURL 过长,超过浏览器限制,可能会导致无法顺利下载,如出现此现象请参考下面详情的方法。
二、saveAs 法
使用这种方法我们需要用到一个三方库 FileSaver.js,该库实现了 HTML5 规范中的 saveAs 方法。
该方法的主要步骤如下:
- 通过 canvas 的 toBlob API 将数据转换为二进制格式。
- 通过 FileSaver.js 提供的 saveAs 方法对该二进制进行下载。
下面是我们的实现:
index.html
<!-- 通过 CDN 引入 FileSaver.js --><!-- 我们也可以通过 npm 引入 https://www.npmjs.com/package/file-saver --><script src="https://cdn.bootcss.com/FileSaver.js/1.3.8/FileSaver.min.js"></script><!-- 待下载对 canvas 元素 --><canvas id="chart" width="1920" height="1080"></canvas><!-- 触发下载操作的按钮 --><button onclick="download('#chart')">下载</button>download.js
function download(selector) { // 通过 API 获取目标 canvas 元素 const canvas = document.querySelector(selector); // 假如 toBlob 方法出现兼容性问题建议引入 eligrey/canvas-toBlob.js canvas.toBlob(function(blob) { saveAs(blob, '文件名称') });}下面我们总结下 saveAs 法的优缺点:
- 优点:基本不限制下载图片的大小(不超过本机内存)
- 缺点:需要引入第三方库
三、涉及的资料
MDN a 标签的说明(包括 download 属性以及其限制):https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/a
MDN 关于 toDataURL 说明: https://developer.mozilla.org/zh-CN/docs/Web/API/HTMLCanvasElement/toDataURL
MDN 关于toBlob 说明:https://developer.mozilla.org/zh-CN/docs/Web/API/HTMLCanvasElement/toBlob
FileSaver.js Github 主页: eligrey/FileSaver.js
FilerServer.js NPM 仓库主页:https://www.npmjs.com/package/file-saver
canvas-toBlob Github 主页: eligrey/canvas-toBlob.js
canvas-toBlob NPM 仓库主页:https://www.npmjs.com/package/canvas-toBlob
假如有不清楚的地方可以在评论中提出,我会及时作出解答,感谢阅读!
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » 将 Canvas 保存为图片并下载至本地