DIV CSS 佈局教程網

用 html2canvas 與 Canvas2Image 實作網頁 DOM 截圖
編輯:關於JavaScript     

想讓使用者把網頁上的某塊內容存成圖片,需要兩件事:把 DOM 轉成 canvas,再把 canvas 轉成圖檔。剛好有兩個開源專案分別負責這兩端。

Canvas2Image:把 canvas 存成圖檔

它利用了 HTML5 canvas 提供的 toDataURL():

var strDataURI = oCanvas.toDataURL();
// returns "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAMgAAADICAYAAACt..."

結果是 base64 編碼的字串,因此需要搭配一個 base64 解碼的函式庫。

寫回頁面有兩種方式。第一種是產生 img 元素插入 DOM,相容性最好:

// 回傳一個含 PNG 圖片的 <img> 元素
var oImgPNG = Canvas2Image.saveAsPNG(oCanvas, true);

第二種是直接觸發下載:

Canvas2Image.saveAsPNG(oCanvas);
// 會跳出另存檔案的對話框

但這種方式送出的資料流 MIME 是 "image/octet-stream",對話框辨識不出適當的副檔名,Firefox 下預設存成 "xxx.part",是個不小的遺憾。當時各瀏覽器的格式支援也不整齊——Opera 與 Safari 只支援 PNG,Firefox 支援面較廣。

html2canvas:把 DOM 畫成 canvas

它的運作方式常被誤解。它並不是把畫面上已經渲染好的 DOM「截圖」,而是在 DOM 載入過程中收集資訊,再用 canvas 重畫一次。因此凡是它沒有實作的 CSS 屬性,畫出來的結果就會與畫面上看到的不同。

主要限制

  • JavaScript 必須同域;跨域情況需要指定代理伺服器(API 有對應參數),圖片也一樣。
  • frame 內的 DOM 樹無法被準確繪製。
  • 因為輸出是 canvas,IE8 這類不支援的瀏覽器需要 FlashCanvas 之類的第三方補充。

該專案網站提供了實際的截圖效果測試頁,成果相當不錯:

API 用法

html2canvas(
  [dom1, dom2],
  {
    logging: false,
    useCORS: false,
    proxy: false,
    onrendered: function(canvas){
      // canvas 就是繪製完成的 canvas 物件
    }
  }
);

這類相對小眾的函式庫,文件品質通常不佳,連 API 定義都得靠讀原始碼,好在它的程式碼寫得相當清楚。官方下載包裡還附了一個 jQuery 插件做封裝,實際上可有可無。

今天的選擇

html2canvas 仍在維護,是目前最通用的方案。若你的場景是「把 canvas 或 SVG 內容存成圖檔」,那麼 toBlob() 加上 URL.createObjectURL 會比 toDataURL 更省記憶體:

canvas.toBlob(function(blob){
  var a = document.createElement('a');
  a.href = URL.createObjectURL(blob);
  a.download = 'screenshot.png';
  a.click();
  URL.revokeObjectURL(a.href);
}, 'image/png');

另外近年出現的 modern-screenshot、html-to-image 等專案改走 SVG foreignObject 路線,對某些 CSS 特性的還原度更高,值得評估。至於真正的「螢幕截圖」,瀏覽器端無法做到,只能透過 getDisplayMedia 取得使用者授權的畫面串流再自行擷取影格。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved