DIV CSS 佈局教程網

用 JavaScript 把 HTML 表格匯出成格式化 Excel
編輯:關於JavaScript     

讓使用者把網頁上的表格下載成 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。

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