DIV CSS 佈局教程網

純前端匯出 CSV:跨瀏覽器建立並下載檔案的做法
編輯:JavaScript綜合知識     

有時候我們需要讓使用者把頁面上的資料(例如雷達圖的標籤與數值)下載成 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 方案在部分瀏覽器上會直接失敗。

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