前端使用html2canvas生成截图:实现步骤与常见坑点解析
本文详细记录前端使用html2canvas库生成组件截图并导出文件的完整流程。重点解析下载插件、引入库、获取DOM及调用API的实现步骤,并深入探讨图片跨域污染、CSS样式(动画、伪元素、滤镜等)丢失等常见坑点。针对跨域问题提供Base64转换与后端配置两种方案,最后对比推荐性能更优的domtoimage方案。
需求:
实现点击按钮导出组件截图及关联数据信息文件的功能。
分析:
前端需先生成组件的截图,携带其他必要参数发送至后端接口,后端返回Excel文件供用户下载。核心难点在于前端组件截图的生成,本文选用html2canvas插件完成该任务。
实现步骤
1.下载插件
npm install html2canvas
2.引入
import html2canvas from 'html2canvas'
3.通过ref拿到要下载组件的dom元素
//下载图标,绑定下载事件
<i class="el-icon-download" style="cursor: pointer;" @click="download"></i>
//需要生成截图的部分
<div class='wrapper' ref='screen'>
...
</div>
4.通过html2canvas生成截图
download() {
//el的全局loading,根据需求,可加可不加,在下载完成时或请求完成时用 loading.close()关闭
const loading = this.$loading({
lock: true,
text: '文件下载中',
spinner: 'el-icon-loading',
background: 'rgba(0, 0, 0, 0.8)'
});
html2canvas(this.$refs.screen, {
backgroundColor: null,//画布背景色(如果未在DOM中指定)。设置null为透明
useCORS: true, //允许跨域
scale: 1 //用于渲染的比例
}).then((canvas) => {
// 此时已经生成我们想要的截图,可以下载查看
const url = canvas.toDataURL('image/png') //转图片链接,为图片的base64形式
const a = document.createElement('a')
const event = new MouseEvent('click')
a.download = '图片'
a.href = url
a.dispatchEvent(event)
loading.close()
// 转为png格式文件格式传以给后端
// formData即为我们要传的内容,如果还有其他参数要传输可以通过formData.append('key',value)来添加
const formData = new FormData()
canvas.toBlob(function(blob) {
formData.append('image', blob, 'image.png')
})
})
},
可能遇到的问题
1.图片跨域
由于项目图片资源托管于独立平台,生成截图时DOM中的图片因跨域导致Canvas“被污染”,无法生成图像。尝试设置useCORS: true及给img标签添加crossorigin="anonymous"均无效。最终采用两种解决方案:一是将图片转换为Base64编码格式,此法可纯前端解决但存在代码冗余、体积增大及可读性降低等缺点;二是修改服务端配置解决跨域。本文采用第一种方案,并提供转换Base64的方法代码。(但这种方法也会有代码冗余体积增大,可读性降低等缺点)
imgUrlToBase64(imgUrl) {
const image = new Image();
image.setAttribute('crossOrigin', 'anonymous');
const imageUrl = imgUrl;
image.src = imageUrl
// image.onload为异步加载
image.onload = () => {
var canvas = document.createElement('canvas');
canvas.width = image.width;
canvas.height = image.height;
var context = canvas.getContext('2d');
context.drawImage(image, 0, 0, image.width, image.height);
var quality = 0.8;
const dataurl = canvas.toDataURL('image/png', quality);
console.log(dataurl, 'dataurl64')
}
},
2.css样式丢失
html2canvas的屏幕截图基于DOM解析,并非截取实际屏幕,而是利用页面可用信息构建图像。该库对以下样式可能无效或支持不完全:
- CSS动画和过渡效果:html2canvas库在截图时不会触发CSS动画和过渡效果,只会捕捉到元素的初始状态。
- CSS伪元素(如::before和::after):html2canvas库无法捕捉到CSS伪元素的样式。
- CSS滤镜效果:html2canvas库无法捕捉到CSS滤镜效果(如blur、grayscale等)。
- CSS变量(CustomProperties):html2canvas库无法解析和应用CSS变量。
- SVG图像:html2canvas库对SVG图像的支持有限,可能无法正确渲染和捕捉SVG图像。
生成截图的其他方案domtoimage
鉴于html2canvas在生成截图时存在诸多弊端,如Canvas绘制耗时较长且绘制过程中屏幕阻塞导致无法交互,后续截图方案改用domtoimage。经测试,domtoimage表现更为流畅,具体可参考使用domtoimage生成截图的相关文章。
总结
到此这篇关于前端html2canvas生成截图实现步骤与踩坑记录的文章就介绍到这了,更多相关前端html2canvas生成截图内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!
JS脚本在App中运行报错怎么解决
2026-11-04 23:11:03
JS怎么使用padStart方法给数字补零
2026-11-04 11:12:03
JS是什么意思?JavaScript全称及基本定义
2026-11-04 08:05:29
JS 使用 toFixed(1) 保留一位小数的基本用法与注意事项
2026-11-03 18:34:57
JS字符串转整数:parseInt与Number的区别及用法
2026-11-03 17:26:54
