html2canvas 使用

html2canvas 使用注意點

最近在搞一個截圖的東西,遇到了一些問題奸鬓,所以貼出代碼焙畔,方便大家一次性解決開發(fā)中會遇到的問題。本篇文章解決了截圖不完整串远,圖片跨域宏多,截圖空白,截圖帶背景顏色(沒有背景圖片的代碼)澡罚,分辨率低伸但,截圖與實際元素位置偏差等問題
首先貼出 插件基礎(chǔ)配置參數(shù)(請仔細(xì)閱讀注釋)

html2canvas 配置參數(shù)

名稱 默認(rèn) 描述
useCORS false 是否嘗試使用CORS從服務(wù)器加載圖像
allowTaint false 是否允許跨域圖像。會污染畫布留搔,導(dǎo)致無法使用canvas.toDataURL 方法
proxy null 代理將用于加載跨域圖像的網(wǎng)址更胖。如果保留為空,則不會加載跨域圖像。
backgroundColor #ffffff 畫布背景色(如果未在DOM中指定)却妨。設(shè)置null為透明
canvas null 現(xiàn)有canvas元素用作繪圖的基礎(chǔ)
foreignObjectRendering false 如果瀏覽器支持饵逐,是否使用ForeignObject渲染
imageTimeout 15000 加載圖像的超時時間(以毫秒為單位)。設(shè)置0為禁用超時管呵。
ignoreElements (element) => false 謂詞功能梳毙,可從渲染中刪除匹配的元素。
logging true 啟用日志以進(jìn)行調(diào)試
onclone null 克隆文檔以進(jìn)行渲染時調(diào)用的回調(diào)函數(shù)可用于修改將要渲染的內(nèi)容捐下,而不會影響原始源文檔账锹。
removeContainer true 是否清除html2canvas臨時創(chuàng)建的克隆DOM元素
scale window.devicePixelRatio 用于渲染的比例。默認(rèn)為瀏覽器設(shè)備像素比率坷襟。
width Element 寬度 canvas的寬度
height Element 高度 canvas的高度
X Element X偏移 裁剪畫布X坐標(biāo)
? Element y偏移 裁剪畫布y坐標(biāo)
scrollX Element 滾動X 渲染元素時要使用的x滾動位置(例如奸柬,如果Element使用position: fixed)
scrollY Element 滾動Y 呈現(xiàn)元素時要使用的y-scroll位置(例如,如果Element使用position: fixed)
windowWidth Window.innerWidth 渲染時使用的窗口寬度Element婴程,這可能會影響媒體查詢之類的內(nèi)容
windowHeight Window.innerHeight 渲染時要使用的窗口高度Element廓奕,這可能會影響媒體查詢之類的內(nèi)容

插件二次封裝,詳細(xì)請看注釋

插件部分

// 獲取截圖
export const getHtmlImage = async (options={}) => {
  let { canvasBox, canvasBoxOffsetLeft, canvasBoxOffsetTop, canvasBoxOffsetHeight } = options
  // 大概估算出档叔,圖片最大面積為maxPixels桌粉,超出只能舍棄一些分辨率,判斷請轉(zhuǎn)到scale配置
  const maxPixels = 880 * 3270 * 0.85;

  console.log('getHtmlImage 配置項=》》》》》》',options)
  return new Promise (async (resolve, reject) => {
    if (!canvasBox) {
      resolve(null)
      return
    }
    
    let domWidth = canvasBox.offsetWidth
    let domHeight = canvasBoxOffsetHeight || canvasBox.offsetHeight
    console.log(domWidth, domHeight)

    //定時為了解決頁面太長衙四,未加載出來時就截圖铃肯,導(dǎo)致圖片不完整
    setTimeout(() => {
      html2canvas(canvasBox, {
        // allowTaint: true, //是否允許跨域,會對canvas造成污染传蹈,導(dǎo)致無法使用canvas.toDataURL 方法
        useCORS: true, //是否允許跨域
        // proxy: 'https://test.test.com',
        backgroundColor: '#fff', //解決生成圖片有白色背景方法押逼,設(shè)置為null
        width: domWidth,
        height: domHeight,
        x: canvasBoxOffsetLeft || canvasBox.offsetLeft, 
        y: canvasBoxOffsetTop || canvasBox.offsetTop,
        // x: 397, 
        // y: 490,
        scale: maxPixels / (domWidth*domHeight) > 1 ? 1 : maxPixels / (domWidth*domHeight),
      }).then((canvas)=>{
        if(canvas){
          let dataUrl = canvas.toDataURL('image/png'); // image/png , image/jpg
          console.log('dataUrl=>>>>>>>>',dataUrl)
          // let newImg = document.createElement("img");
          // // //newImg.style = "display:none;";    //如果要導(dǎo)出惦界,這兒可以隱藏挑格,然后用canvas2image搞定
          // newImg.src = dataUrl;
          // document.body.appendChild(newImg);
  
          resolve(dataUrl)
        }else{
          resolve(null)
        }
      });
    }, 500);
  })
  
}

普通直接截取某個元素,直接調(diào)用方法

// 截圖模塊
let canvasBox = this.document.querySelector('.canvasBox') || null
// await接收圖片地址 
let url = await getHtmlImage({canvasBox})

解決截圖元素是定位的沾歪,導(dǎo)致截圖位置偏差漂彤,高度計算不準(zhǔn),截圖空白的問題灾搏,position: fixed


// 截圖模塊
let canvasBox = this.document.querySelector('.canvasBox') || null
let scrollTop = document.documentElement.scrollTop
// 左側(cè)計算方法挫望, 元素距離屏幕左側(cè)的距離
let canvasBoxOffsetLeft = canvasBox ? canvasBox.getBoundingClientRect().left : 0;
// 頂部計算方法, 元素距離頂部距離 + body滾動高度
let canvasBoxOffsetTop = canvasBox ? canvasBox.offsetTop + scrollTop : 0;

// await接收圖片地址 
let url = await getHtmlImage({
  canvasBox,
  canvasBoxOffsetLeft,
  canvasBoxOffsetTop
})

如有寫得錯誤/改進(jìn)的地方确镊,可回復(fù)評論

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末士骤,一起剝皮案震驚了整個濱河市范删,隨后出現(xiàn)的幾起案子蕾域,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,104評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件旨巷,死亡現(xiàn)場離奇詭異巨缘,居然都是意外死亡,警方通過查閱死者的電腦和手機采呐,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,816評論 3 399
  • 文/潘曉璐 我一進(jìn)店門若锁,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人斧吐,你說我怎么就攤上這事又固。” “怎么了煤率?”我有些...
    開封第一講書人閱讀 168,697評論 0 360
  • 文/不壞的土叔 我叫張陵仰冠,是天一觀的道長。 經(jīng)常有香客問我蝶糯,道長洋只,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 59,836評論 1 298
  • 正文 為了忘掉前任昼捍,我火速辦了婚禮识虚,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘妒茬。我一直安慰自己担锤,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 68,851評論 6 397
  • 文/花漫 我一把揭開白布郊闯。 她就那樣靜靜地躺著妻献,像睡著了一般。 火紅的嫁衣襯著肌膚如雪团赁。 梳的紋絲不亂的頭發(fā)上育拨,一...
    開封第一講書人閱讀 52,441評論 1 310
  • 那天,我揣著相機與錄音欢摄,去河邊找鬼熬丧。 笑死,一個胖子當(dāng)著我的面吹牛怀挠,可吹牛的內(nèi)容都是我干的析蝴。 我是一名探鬼主播,決...
    沈念sama閱讀 40,992評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼绿淋,長吁一口氣:“原來是場噩夢啊……” “哼闷畸!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起吞滞,我...
    開封第一講書人閱讀 39,899評論 0 276
  • 序言:老撾萬榮一對情侶失蹤佑菩,失蹤者是張志新(化名)和其女友劉穎盾沫,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體殿漠,經(jīng)...
    沈念sama閱讀 46,457評論 1 318
  • 正文 獨居荒郊野嶺守林人離奇死亡赴精,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,529評論 3 341
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了绞幌。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片蕾哟。...
    茶點故事閱讀 40,664評論 1 352
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖莲蜘,靈堂內(nèi)的尸體忽然破棺而出谭确,到底是詐尸還是另有隱情,我是刑警寧澤票渠,帶...
    沈念sama閱讀 36,346評論 5 350
  • 正文 年R本政府宣布琼富,位于F島的核電站,受9級特大地震影響庄新,放射性物質(zhì)發(fā)生泄漏鞠眉。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 42,025評論 3 334
  • 文/蒙蒙 一择诈、第九天 我趴在偏房一處隱蔽的房頂上張望械蹋。 院中可真熱鬧,春花似錦羞芍、人聲如沸哗戈。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,511評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽唯咬。三九已至,卻和暖如春畏浆,著一層夾襖步出監(jiān)牢的瞬間胆胰,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,611評論 1 272
  • 我被黑心中介騙來泰國打工刻获, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留蜀涨,地道東北人。 一個月前我還...
    沈念sama閱讀 49,081評論 3 377
  • 正文 我出身青樓蝎毡,卻偏偏與公主長得像厚柳,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子沐兵,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,675評論 2 359