讓使用者把網頁上的表格下載成 Excel,是很常見的需求。這裡介紹一個不需要任何後端或第三方庫的做法:把表格轉成 Excel 認得的 XML 格式。
把 Excel 檔案「另存新檔」選 XML 格式,你會得到一份 SpreadsheetML 結構的檔案。既然 Excel 自己就認這個格式,那我們只要在前端組出同樣結構的字串,再讓使用者下載並以 .xls 或 .xml 副檔名存檔,Excel 就能正常開啟,而且連格式、合併儲存格、數字型別都保留下來——這是單純輸出 CSV 做不到的。
function getTableDataByXML(inTable, inWindow) {
var rows = 0;
var tblDocument = document;
if (!!inWindow && inWindow != "") {
if (!document.all(inWindow)) {
return null;
} else {
tblDocument = eval(inWindow).document;
}
}
var inTbl = tblDocument.getElementById(inTable);
var outStr = "<?xml version=\"1.0\"?>\n";
outStr += "<?mso-application progid=\"Excel.Sheet\"?>\n";
outStr += "<Workbook xmlns=\"urn:schemas-microsoft-com:office:spreadsheet\"";
outStr += " xmlns:o=\"urn:schemas-microsoft-com:office:office\"";
outStr += " xmlns:x=\"urn:schemas-microsoft-com:office:excel\"";
outStr += " xmlns:ss=\"urn:schemas-microsoft-com:office:spreadsheet\">\n";
outStr += "<Worksheet ss:Name=\"Sheet1\">\n";
outStr += "<Table>\n";
var re = /^[0-9]+.?[0-9]*$/; // 是否為數字
if (inTbl != null) {
for (var j = 0; j < inTbl.rows.length; j++) {
outStr += "<Row ss:AutoFitHeight=\"0\">\n";
for (var i = 0; i < inTbl.rows[j].cells.length; i++) {
// 處理 rowSpan:前面幾列的第一格要補空位
if (i == 0 && rows > 0) {
outStr += "<Cell><Data ss:Type=\"String\"></Data></Cell>\n";
rows -= 1;
}
var cellValue = inTbl.rows[j].cells[i].innerText;
// 11 位數以內的數字用 Number 型別,超過的當字串處理(避免科學記號與精度流失)
if (re.test(cellValue) && (new String(cellValue)).length < 11) {
outStr += "<Cell><Data ss:Type=\"Number\">" + cellValue + "</Data></Cell>\n";
} else {
outStr += "<Cell><Data ss:Type=\"String\">" + cellValue + "</Data></Cell>\n";
}
// 處理 colSpan:補上合併所佔的空格
if (inTbl.rows[j].cells[i].colSpan > 1) {
for (var k = 0; k < inTbl.rows[j].cells[i].colSpan - 1; k++) {
outStr += "<Cell><Data ss:Type=\"String\"></Data></Cell>\n";
}
}
if (i == 0) {
if (rows == 0 && inTbl.rows[j].cells[i].rowSpan > 1) {
rows = inTbl.rows[j].cells[i].rowSpan - 1;
}
}
}
outStr += "</Row>\n";
}
} else {
outStr = null;
alert("你要導出的表不存在!");
return;
}
outStr += "</Table>\n</Worksheet>\n</Workbook>";
return outStr;
}
數字型別判斷。小於 11 位的數字標成 Number,讓 Excel 可以繼續做加總、排序;超過 11 位(身分證、手機、訂單編號這類)則標成 String,避免被顯示成 1.23457E+10 而失去精度。這個判斷很務實。
合併儲存格。rowSpan 與 colSpan 需要手動補上空白儲存格,因為 SpreadsheetML 沒有合併的概念,只能用「留空」來模擬視覺效果。
那段 mso-application 處理指令是關鍵:它會讓 Windows 註冊表裡的 Excel 直接接管這個檔案,點兩下就能開啟,不會先被瀏覽器下載成純文字。
function downloadTableAsExcel(tableId, filename){
var xml = getTableDataByXML(tableId, '');
var blob = new Blob(['\ufeff' + xml], { type: 'application/vnd.ms-excel' });
var a = document.createElement('a');
a.href = URL.createObjectURL(blob);
a.download = filename + '.xls';
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
URL.revokeObjectURL(a.href);
}
字首的 \ufeff 是 UTF-8 BOM,能避免中文在 Excel 中變成亂碼。
eval(inWindow).document 用 eval 取得 iframe 物件,既慢又不安全。改用 document.getElementById(inWindow).contentDocument 或 window.frames[inWindow].document。document.all(inWindow) 是非標準 API,現代瀏覽器不建議使用。&、<、> 未做 XML 轉義,儲存格內容若含這些字元會產生格式錯誤的檔案。輸出前應呼叫一個 escape 函式處理。+= 反覆拼接大量字串會產生很多中間物件。改用陣列 push 再 join('') 效能更好。最後提醒:這個方法產出的是「偽 xls」(實際是 XML),新版 Excel 開啟時可能出現格式警告。若要正式環境使用,建議改用 SheetJS 這類專門的函式庫,輸出真正的 .xlsx。