論壇專案做到導出功能時遇到一個問題:點下導出按鈕,頁面上的 table 存成 Excel 檔之後,內容都在,樣式卻全丟了。追下去發現原因並不在程式邏輯,而在 CSS 的套用方式。這裡把整個排查過程與兩種解法整理出來。
頁面裡的表格用 class 指定顏色與字型,畫面上顯示正常;但透過 JavaScript 把 table 的 HTML 丟給 Excel 後,只有文字與框線,顏色完全不見。
1. 表格用的是 class,而不是 inline style。導出的時候並不會把 <style> 裡的 class 定義一起帶走。Excel 在解析這段 HTML 時只看得懂直接寫在元素上的 style 屬性,class 指向的規則它無從查詢,於是就全部忽略了。
換句話說,style 是實際套用的樣式宣告,而 class 只是一個「類別名稱」,真正的宣告寫在別處。導出檔案時只有前者會被保存。
2. 把類定義移到 table 內部也可以導出。如果一定要保留 class 寫法,另一條路是把 <style> 區塊搬到 <table></table> 之間,讓樣式定義與表格在同一段被導出的 HTML 裡。
後端輸出時直接產生行內樣式:
// 原本
<td class="${getClass()}">
// 改成
<td style="color:${getStyle()};">
導出的觸發程式碼本身很單純:
$('#export').click(function () {
saveAsExcel($('h3').text(), $('#table').html().replace(/( )+/gi,''));
});
這裡有個值得記下的現象:Excel 只認得 table 標籤,用 saveAsExcel 自動另存時 class 定義會遺失;但如果是手動複製貼上到 Excel,class 定義反而能保留。差別在於自動化與手動的複製流程不同——手動複製時瀏覽器會把計算後的樣式一併放進剪貼簿,自動化則只是原封不動地送出 HTML 字串。
將原本寫在 <head><style></style></head> 中的類定義,整段移到 <table></table> 之間即可。這樣 $('#table').html() 取到的內容就包含了樣式定義,Excel 解析時自然能查到對應規則。
兩種方案裡,方案一(inline style)比較可靠,因為它不依賴 Excel 如何解析 <style> 區塊,也不受 table 結構影響。實作上可以寫一個轉換函式,在導出前把 DOM 上所有元素的 computed style 我需要的值(顏色、背景、框線、對齊)讀出來寫成 inline style,再序列化整個 table。
另外提醒兩點:一是若表格資料量很大,這種 HTML 導出的方式會產生非常大的字串,記憶體與 Excel 開啟速度都會受影響,正式環境建議改用 SheetJS(xlsx)或後端搭配 EPPlus、Apache POI 直接產生真正的 .xlsx 檔;二是使用者提供的內容若未轉義就寫進 HTML,可能造成 XSS,導出前務必處理。
以上就是這個 table 導出 Excel 樣式遺失問題的原因分析與兩種解法。