後台報表常見的需求:把畫面上的表格給使用者下載成 Excel。傳統做法要在伺服器端另外產生檔案,但其實只要頁面裡已經有 table,就能靠一段 HTML 轉 Excel 的模板加上 Base64 編碼,在瀏覽器端完成下載,不必多一次往返。
function formattable(tableHtml, sheetName) {
var template = '<html xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:x="urn:schemas-microsoft-com:office:excel"
xmlns="https://www.w3.org/TR/REC-html40"><head>
<!--[if gte mso 9]><xml><x:ExcelWorkbook><x:ExcelWorksheets>
<x:ExcelWorksheet><x:Name>{worksheet}</x:Name>
<x:WorksheetOptions><x:DisplayGridlines/></x:WorksheetOptions>
</x:ExcelWorksheet></x:ExcelWorksheets></x:ExcelWorkbook></xml><![endif]-->
<meta http-equiv="content-type" content="text/plain; charset=UTF-8"/>
</head><body><table>{table}</table></body></html>';
var ctx = { worksheet: sheetName, table: tableHtml };
var downloadLink = document.createElement("a");
downloadLink.href = 'data:application/vnd.ms-excel;base64,'
+ base64(format(template, ctx));
downloadLink.download = sheetName + ".xls";
document.body.appendChild(downloadLink);
downloadLink.click();
document.body.removeChild(downloadLink);
}
function base64(s) {
return $.base64.btoa(unescape(encodeURIComponent(s)));
}
var format = function (s, c) {
return s.replace(/{(\w+)}/g, function (m, p) { return c[p]; });
};
format 是最單純的模板替換,把 {worksheet}、{table} 這類佔位符換成實際內容。
base64 負責編碼。這裡刻意先 encodeURIComponent 再 unescape,目的是把中文正確轉成位元組序列,否則 UTF-8 的中文字會變成亂碼。它依賴 $.base64 這個額外外掛(如 jquery-base64),使用前記得引入。
formattable 組裝模板、動態建立 <a> 並觸發點擊。之所以要把連結掛進 DOM 再移除,是因為部分瀏覽器(尤其舊版 Firefox)對未插入文件的節點不觸發下載。
formattable($("#MyTable").html(), "報表");
這個做法本質上是「讓 Excel 去讀一份 HTML」,所以輸出的是 .xls 而非真正的 .xlsx,格式控制能力有限:合併儲存格、公式、數字型別都需要靠特定的 HTML 屬性與樣式硬湊,跨版本相容性也不 guarantee。
如果報表需要正式列印或大量運算,建議改走伺服器端產生檔案的路線,例如用 SheetJS 產生 xlsx、或 C# 端使用 ClosedXML/EPPlus 輸出,再把檔案流回傳給前端下載。以「快速匯出目前畫面」為目標時,上面這段程式碼最省事;以「正式報表」為目標時,伺服器端才是長期解。
另外提醒:使用者貼進表格的內容若含 HTML,匯出時應先消毒,避免在 Excel 開啟時被當成外部連結或公式注入。