前端html2canvas生成截图【实现步骤与踩坑】

需求：点击下载可以导出组件的截图及数据信息文件
分析：前端生成组件截图，带着其他参数传给后端，拿到excel文件并下载。关键在于生成组件的截图，这里通过html2canvas插件来实现。

文章目录

实现步骤

1.下载插件

npm install html2canvas

2.引入

import html2canvas from'html2canvas'

3.通过ref拿到要下载组件的dom元素

    //下载图标，绑定下载事件
    <iclass="el-icon-download"style="cursor: pointer;"@click="download"></i>

    //需要生成截图的部分
    <divclass='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 =newMouseEvent('click')
           a.download ='图片'
           a.href = url
           a.dispatchEvent(event)
           loading.close()// 转为png格式文件格式传以给后端// formData即为我们要传的内容,如果还有其他参数要传输可以通过formData.append('key',value)来添加const formData =newFormData()
           canvas.toBlob(function(blob){
            formData.append('image', blob,'image.png')})})},

可能遇到的问题

1.图片跨域

因为项目的图片资源是托管在另一个平台上，在生成截图时，原有dom的图片由于跨域 canvas “被污染”,一直无法生成，尝试了多种办法，设置useCORS: true且给img标签设crossorigin="anonymous"也无法解决。最后找到两种解决方案:一种是把图片转为编码格式base64，此方法可以纯前端解决该问题，另一种是修改服务端的配置来解决跨域问题。采用的是第一种方案，附上转base64的方法。(但这种方法也会有代码冗余体积增大，可读性降低等缺点)

imgUrlToBase64(imgUrl){const image =newImage();
       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 的，不会生成实际的屏幕截图，而是基于页面上可用的信息构建屏幕截图，html2canvas库对以下样式可能无效或不完全支持：

• 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生成截图。