有時候我們需要讓使用者把頁面上的資料(例如雷達圖的標籤與數值)下載成 CSV,且不希望多一次後端往返。這件事在瀏覽器端就能完成,但 IE 與其他瀏覽器的做法不同,需要分開處理。
$("#radarDLBut").click(function () {
var data = [
displayData["radar_chart"]["r_label"],
displayData["radar_chart"]["r_default"]
];
var csvContent = "data:text/csv;charset=utf-8,ufeff";
if (window.navigator.msSaveOrOpenBlob) {
csvContent = "ufeff";
}
data.forEach(function (infoArray, index) {
dataString = infoArray.join(",");
csvContent += index < data.length ? dataString + "n" : dataString;
});
if (window.navigator.msSaveOrOpenBlob) {
// IE 走 Blob 路線
var blob = new Blob(
[decodeURIComponent(encodeURI(csvContent))],
{ type: "text/csv;charset=utf-8;" }
);
navigator.msSaveBlob(blob, 'subject.csv');
} else {
// 其他瀏覽器用 a 標籤的 download 屬性
var encodedUri = encodeURI(csvContent);
var link = document.createElement("a");
link.setAttribute("href", encodedUri);
link.setAttribute("download", "subject.csv");
document.body.appendChild(link);
link.click();
}
});
現代瀏覽器走的是 Data URI 路線:把 CSV 內容前面加上 data:text/csv;charset=utf-8,,讓整個字串變成一個可直接開啟的網址,再動態建立 <a> 元素、設定 download 屬性並觸發點擊。使用者就會看到正常的下載行為。
舊版 IE 不支援 download 屬性,因此改用 navigator.msSaveBlob(),把內容包成 Blob 後直接存檔。這也是為什麼程式開頭要檢查 window.navigator.msSaveOrOpenBlob 是否存在。
原始程式碼有幾處會造成實際故障,使用前建議先處理:
第一,csvContent += index < data.length ? dataString + "n" : dataString; 這裡的 "n" 應為換行符號 "\n",否則所有資料會黏在同一行。
第二,判斷式應為 index < data.length - 1,目前的寫法會在最後一筆之後仍附加換行。
第三,BOM 前綴 ufeff 應寫為 \ufeff(Unicode 轉義),少了反斜線就只是四個普通字母。
第四,dataString 未宣告,會變成全域變數,應加上 var 或 let。
第五,link.click() 之後可加上 link.remove() 清掉暫時掛上的節點。
第六,若欄位內容本身含逗號、雙引號或換行,需用雙引號包起來並把內部的引號加倍,否則 CSV 結構會被打散。這是匯出功能最常見的資料正確性問題。
如果不需要支援已停止維護的 IE,可以直接用 Blob 搭配 URL.createObjectURL,程式碼更短也更可靠:
var csv = "\ufeff" + rows.map(function (r) { return r.join(","); }).join("\n");
var blob = new Blob([csv], { type: "text/csv;charset=utf-8;" });
var url = URL.createObjectURL(blob);
var a = document.createElement("a");
a.href = url;
a.download = "subject.csv";
document.body.appendChild(a);
a.click();
a.remove();
URL.revokeObjectURL(url);
這個版本同樣能處理含中文的內容(BOM 確保 Excel 正確判讀 UTF-8),而且不受 Data URI 長度限制的影響——資料量大時,Data URI 方案在部分瀏覽器上會直接失敗。