DIV CSS 佈局教程網

EasyUI DataGrid 導出 Excel:兩段 JS 代碼搞定
編輯:JQuery入門技巧     

純 JavaScript 導出 Excel 的方案並不多見,主流做法是調用客戶端已安裝的 Office Excel COM 組件。本文說明如何讓 EasyUI 的 DataGrid 配合 JS 把表格數據寫進 Excel。

一、最精簡的核心代碼

function Exproter() {
    var rows = $('#test').datagrid('getRows');          // 取得 DataGrid 的數據行
    var oXL = new ActiveXObject("Excel.Application");   // 創建 Excel COM 對象
    var oWB = oXL.Workbooks.Add();                      // 新建工作簿
    var oSheet = oWB.ActiveSheet;                       // 取得當前工作表

    for (var i = 0; i < rows.length; i++) {
        oSheet.Cells(i + 1, 1).value = rows[i].O_NAME;  // 逐行寫入指定字段
    }

    oXL.Visible = true;    // 讓 Excel 可見
}

原理並不複雜:通過 ActiveXObject("Excel.Application") 在客戶機本地拉起一個 Excel 進程,然後像操作對象一樣往 Cells 裡塞值。

二、能跑起來的前提條件

1. 機器上已安裝 Excel。沒有 Office 環境,ActiveXObject 會直接報錯。

2. IE 安全設置允許。Internet 選項 → 安全 → Internet 區域 → 自定義級別,把「對沒有標記為安全的 ActiveX 控件進行初始化和腳本運行」設為「啟用」。

3. 只能運行於 Internet Explorer。ActiveXObject 是 IE 專屬對象,Chrome、Firefox、Edge(Chromium)都不支持,這是此方案最大的限制。

三、升級版:動態讀取列頭,讓導出內容與表格一致

上面的代碼把字段名寫死了,表格一改就得改 JS。更好的做法是直接從 DataGrid 的配置中取出列定義:

function ExporterExcel() {
    var rows = $('#tt').datagrid('getRows');                       // 數據行
    var columns = $("#tt").datagrid("options").columns[0];         // 列定義

    var oXL = new ActiveXObject("Excel.Application");
    var oWB = oXL.Workbooks.Add();
    var oSheet = oWB.ActiveSheet;

    oSheet.name = "導出Excel報表";                                  // 設置工作表名稱

    // 寫入表頭
    for (var i = 0; i < columns.length; i++) {
        oSheet.Cells(1, i + 1).value = columns[i].title;
    }

    // 寫入數據,按列定義中的 field 取值
    for (var i = 0; i < rows.length; i++) {
        for (var j = 0; j < columns.length; j++) {
            oSheet.Cells(i + 2, j + 1).value = rows[i][columns[j].field];
        }
    }

    oXL.Visible = true;
}

這裡有兩個細節:Cells 的索引從 1 開始,所以表頭在第 1 行、數據從第 2 行起;columns 是二維數組,需要取 [0] 才是當前可見的列分組。

四、更值得推薦的替代方案

ActiveX 方案的限制實在太多:只支援 IE、要求裝 Office、需要用戶手動降低安全級別。在今天的項目中,更實際的做法有以下幾種:

方案一:後端生成。把 DataGrid 的數據以 JSON 提交給後端,用 EPPlus、NPOI(.NET)或 Apache POI(Java)生成真正的 xlsx 文件並返回下載。兼容性最好,也能處理合併單元格、公式、樣式等複雜需求。

方案二:前端庫生成。SheetJS(xlsx)或 FileSaver.js 可以在瀏覽器端把 JSON 轉成 xlsx 並觸發下載,無需服務端參與,支援所有現代瀏覽器。

// 使用 SheetJS 的示意寫法
var rows = $('#tt').datagrid('getRows');
var ws = XLSX.utils.json_to_sheet(rows);
var wb = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(wb, ws, "導出報表");
XLSX.writeFile(wb, "data.xlsx");

方案三:導出 CSV。若只是需要能用 Excel 打開的數據,生成 CSV 最省事,但要注意加 BOM 頭避免中文亂碼,且無法保留樣式。

總結:ActiveX 方案可以作為「客戶強制要求只用 IE 且環境可控」的兜底,新項目請直接選方案一或方案二。

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