DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
SVG、Canvas 與圖片三方轉換:解決郵件與 PDF 無法顯示的實戰思路
編輯:HTML5詳解     

這個需求來得很實際:要把報表頁面的內容整理成正文,將原頁面轉為 PDF 當附件寄給主管。問題在於——報表類網站的圖表控件在 HTML5 時代不外乎 Canvas 或 SVG,而 SVG 在郵件(如 FoxMail)正文中無法正常顯示;直覺地改成 Canvas,卻發現 Canvas 同樣顯示不出來。最後把 Canvas 再轉成圖片,問題才真正解決。

為什麼非得一路轉到圖片

郵件用戶端與許多人用的文件檢視器,對 HTML 的支援程度遠低於瀏覽器:它們多半只吃傳統的 <img>,既不會執行 JavaScript,也不保證支援 SVG 或 Canvas 的渲染。因此「SVG → Canvas → 圖片」這條路徑,本質上是一個把所有先進技術都退化為最保守格式的過程。

第一步:取出 SVG 內容

<div id="svgContainer">
  <svg id="svg"></svg>
</div>

<script>
var svgHtml = document.getElementById('svgContainer').innerHTML;
</script>

把 SVG 標籤連同內容序列化成字串,是後續轉換的輸入。(原範例寫成 innerHtml(),正確的 DOM 屬性名稱是 innerHTML。)

第二步:用 canvg 把 SVG 畫進 Canvas

Google 開放的 canvg 是一個把 SVG 字串渲染到 Canvas 上的 JavaScript 函式庫,可從專案網站下載後自行託管,或直接遠端引用。

<canvas id="myCanvas"></canvas>

<script src="canvg.js"></script>
<script>
// 第一個參數是 canvas 的 id,第二個參數是 SVG 內容
canvg('myCanvas', svgHtml);
</script>

第三步:把 Canvas 變成圖片

<script>
var canvas   = document.getElementById('myCanvas');
var imgSrc   = canvas.toDataURL('image/png');   // 取得圖片的完整資料
document.getElementById('preview').src = imgSrc;
</script>

<img id="preview" src="" alt="報表預覽" />

toDataURL('image/png') 會回傳一組 data:image/png;base64,... 的字串,可直接塞進 <img> 的 src,也能當成附件或寫入 PDF 的素材。若要強制下載,可把它換成 image/octet-stream 再指定給 location.href。

實作上會踩到的坑

  • 方法名大小寫:是 toDataURL,不是 toDataUrl。這是這個流程最常見的失敗原因。
  • 跨來源圖片:若 SVG 或圖表參照了外部來源的圖片,Canvas 會被標記為「污染」(tainted),toDataURL 會直接丟出安全性錯誤。處理方式是讓圖片與頁面同源,或於伺服器端設定 CORS 並為 Image 指定 crossOrigin。
  • 字型:canvg 渲染文字時若找不到指定字型,外觀會與畫面上看到的落差很大,必要時先把文字轉成路徑。
  • 解析度:Canvas 的 width/height 決定輸出圖的清晰度。要放進 PDF,建議以 2 倍裝置像素設定尺寸,再用 CSS 縮回顯示大小,避免模糊。

現代的替代做法

如果今天重做一次,除了 canvg,還有幾條路可選:用 html2canvas 直接把整段 DOM 截圖;或更乾脆地在伺服器端產生圖表(例如以 SVG 轉 PNG 的服務)後再寄出。但無論用哪一種,「最終一律轉成點陣圖」這個結論不變——這也是為什麼這個思路值得記住:不同環境對 SVG 與 Canvas 的支持程度不一,至少讓我們的報表在任何終端上都有辦法正確呈現,即使最後只能退成圖片。

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