需求:点击下载可以导出组件的截图及数据信息文件
分析:前端生成组件截图,带着其他参数传给后端,拿到excel文件并下载。关键在于生成组件的截图,这里通过html2canvas插件来实现。
文章目录
实现步骤1.下载插件2.引入3.通过ref拿到要下载组件的dom元素4.通过html2canvas生成截图 可能遇到的问题1.图片跨域2.css样式丢失 生成截图的其他方案domtoimage
实现步骤
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 的,不会生成实际的屏幕截图,而是基于页面上可用的信息构建屏幕截图,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生成截图。