這個需求來得很實際:要把報表頁面的內容整理成正文,將原頁面轉為 PDF 當附件寄給主管。問題在於——報表類網站的圖表控件在 HTML5 時代不外乎 Canvas 或 SVG,而 SVG 在郵件(如 FoxMail)正文中無法正常顯示;直覺地改成 Canvas,卻發現 Canvas 同樣顯示不出來。最後把 Canvas 再轉成圖片,問題才真正解決。
郵件用戶端與許多人用的文件檢視器,對 HTML 的支援程度遠低於瀏覽器:它們多半只吃傳統的 <img>,既不會執行 JavaScript,也不保證支援 SVG 或 Canvas 的渲染。因此「SVG → Canvas → 圖片」這條路徑,本質上是一個把所有先進技術都退化為最保守格式的過程。
<div id="svgContainer">
<svg id="svg"></svg>
</div>
<script>
var svgHtml = document.getElementById('svgContainer').innerHTML;
</script>
把 SVG 標籤連同內容序列化成字串,是後續轉換的輸入。(原範例寫成 innerHtml(),正確的 DOM 屬性名稱是 innerHTML。)
Google 開放的 canvg 是一個把 SVG 字串渲染到 Canvas 上的 JavaScript 函式庫,可從專案網站下載後自行託管,或直接遠端引用。
<canvas id="myCanvas"></canvas>
<script src="canvg.js"></script>
<script>
// 第一個參數是 canvas 的 id,第二個參數是 SVG 內容
canvg('myCanvas', svgHtml);
</script>
<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。這是這個流程最常見的失敗原因。toDataURL 會直接丟出安全性錯誤。處理方式是讓圖片與頁面同源,或於伺服器端設定 CORS 並為 Image 指定 crossOrigin。width/height 決定輸出圖的清晰度。要放進 PDF,建議以 2 倍裝置像素設定尺寸,再用 CSS 縮回顯示大小,避免模糊。如果今天重做一次,除了 canvg,還有幾條路可選:用 html2canvas 直接把整段 DOM 截圖;或更乾脆地在伺服器端產生圖表(例如以 SVG 轉 PNG 的服務)後再寄出。但無論用哪一種,「最終一律轉成點陣圖」這個結論不變——這也是為什麼這個思路值得記住:不同環境對 SVG 與 Canvas 的支持程度不一,至少讓我們的報表在任何終端上都有辦法正確呈現,即使最後只能退成圖片。