前端html2canvas生成截圖實現步驟與踩坑記錄

更新時間：2024年09月28日 08:55:11 作者：Lucky_Dog_c

這篇文章主要介紹了前端html2canvas生成截圖實現步驟與踩坑的相關資料,主要步驟包括使用html2canvas生成截圖以及處理圖片跨域和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')
       }
     },