純 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 且環境可控」的兜底,新項目請直接選方案一或方案二。