DIV CSS 佈局教程網

把網頁表格匯出成 Excel:以 ActiveX 操控 Excel 的實作
編輯:JavaScript綜合知識     

舊式企業內部系統常有「把報表匯出成 Excel」的需求。在只支援 IE 的年代,最直接的方式是用 ActiveX 在本機開啟 Excel,再逐格寫入資料。以下說明實作與限制。

使用方式

先在頁面引入腳本,並把表格的 id 與 class 都設為 tableNr:

<script type="text/javascript" src="execl.js"></script>

<input style="height:26px" type="button" name="btnExcel"
       value="導出excel"
       onClick="ExportExcel(this,'tableNr','','表頭');" />

函式簽章與注意事項

/**
 * 導出到 Excel
 * 注意事項:
 * 1. 表格標記內不得有註解,因為 childNodes 會把註解也算進去
 * 2. 若出錯,需要手動關閉 Excel 進程,否則它會一直留在背景執行
 * 3. td 中只能有一個 input 值
 * 4. 非 td 之間不可有其他節點,否則會報缺少「;」錯誤
 */
function ExportExcel(btn, TabId, strCols, sTitle, sHeader, sFooter) {

主要流程

  1. 取得表格並統計行列數:透過 document.getElementById(TabId) 取得表格,用 childNodes.length 算出列數,並把有 colSpan 的 td 展開計算實際欄數。
  2. 建立 Excel 物件:new ActiveXObject("Excel.Application"),若失敗代表未安裝 Excel 或未開放權限。
  3. 寫入標題與副標題:用 Range(...).MergeCells = true 合併儲存格並置中。
  4. 逐列逐格寫入:遍歷 td,依 rowSpan/colSpan 決定要合併的範圍,並處理 input[type=text] 與 radio 的取值。
  5. 寫入表尾:自動帶入製表人與時間。
  6. 版面調整:Columns.AutoFit 自動調整欄寬,並為每一列增加行高避免過於擁擠。
  7. 顯示結果:設定 oXL.Visible = true 讓使用者看到 Excel 視窗,最後把物件變數設為 null 釋放。

權限設定的關鍵片段

try {
  var oXL = new ActiveXObject("Excel.Application");
} catch (e) {
  alert("無法啟動 Excel,請確保電腦中已經安裝了 Excel!\n\n" +
        "如果已經安裝,請將 IP 位址加入信任站點,並調整 IE 信任站點的安全級別。\n\n" +
        "具體操作:\n" +
        "工具 → Internet 選項 → 安全 → 自定義級別 →\n" +
        "ActiveX 控件和插件 → 對未標記為可安全執行腳本的 ActiveX 控件初始化並執行腳本 → 啟用 → 確定");
  btn.style.cursor = "hand";
  return;
}

oXL.Workbooks.Add();
var obook  = oXL.ActiveWorkBook;
var osheet = obook.Sheets(1);

另外程式還開了一個小視窗顯示進度條,用 window.open 建立後,以 m_pub_wzs_progress_show(列數, 目前列) 更新已處理的行數,匯出完成再關掉。

為什麼現在不該再用這個方法

這個方案的限制非常明確:

  • 只能在 Internet Explorer 上執行,其他瀏覽器完全無效。
  • 需要降低安全性設定才能運作,等於為使用者電腦開了一道風險之門。
  • ActiveX 是一段在本機執行的程式碼,一旦被有心人士利用,後果嚴重。微軟已於 2021 年停止支援 IE 11,這條路實際上已經走不通。

現代替代方案

如果目標只是「讓使用者下載一份 Excel 檔」,伺服器端輸出是最簡單可靠的做法:

// 以 CSV 為例(Excel 可直接開啟)
Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="report.csv"

// 記得加上 UTF-8 BOM,否則 Excel 開啟中文會亂碼

前端也可以直接產生檔案,不必經過伺服器:

// 方式一:用 SheetJS(社群維護的 xlsx 函式庫)
import * as XLSX from "xlsx";
const ws = XLSX.utils.table_to_sheet(document.getElementById("tableNr"));
const wb = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(wb, ws, "報表");
XLSX.writeFile(wb, "report.xlsx");

// 方式二:ExcelJS,支援樣式、公式與合併儲存格

這兩種做法都支援合併儲存格、樣式與公式,且不依賴任何瀏覽器專屬技術,跨平台可用。若報表由後端產生,也可考慮用 EPPlus、NPOI、ClosedXML(.NET)或 Apache POI(Java)在伺服器端直接輸出 .xlsx。

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