DIV CSS 佈局教程網

用隱藏 iframe 觸發檔案下載
編輯:JavaScript綜合知識     

用 a 標籤連到檔案網址,瀏覽器不一定會下載,可能直接在頁面上開啟。若不想把使用者導離目前頁面,可以把請求交給一個隱藏的 iframe。

原始實作

<script>
function download() {
  // 要下載的檔案網址
  var url = "https://music.baidu.com/data/music/file?link=https://zhangmenshiting.baidu.com/data2/music/13618994/13618995183600128.mp3?xcode=48d4a720fcd9a974586066d0145f7207";
  document.getElementById("ifile").src = url;
}
</script>

<a href="#" onclick="download()">download</a>

<iframe id="ifile" style="display:none"></iframe>

原理

把 iframe 的 src 設成檔案網址,請求就在那個隱藏的框架裡進行。伺服器回應時若帶有 Content-Disposition: attachment 標頭,瀏覽器就會跳出下載對話框;而因為一切都發生在隱藏 iframe 中,主頁面的內容與捲動位置完全不受影響。

現代寫法:下載屬性

HTML5 的 download 屬性可以直接指定下載行為,同源的情況下甚至能自訂檔名:

<a href="/files/report.pdf" download="季度報告.pdf">下載報告</a>

用 JavaScript 動態觸發:

function downloadFile(url, filename) {
  var a = document.createElement('a');
  a.href = url;
  a.download = filename || '';
  document.body.appendChild(a);
  a.click();
  a.remove();
}

跨來源時怎麼辦

download 屬性對跨來源的資源會被忽略,此時必須由伺服器端下 Content-Disposition 標頭:

Content-Disposition: attachment; filename="report.pdf"

若無法控制對方伺服器,可以改用 fetch 抓成 Blob 再觸發下載,但這會受 CORS 限制:

async function downloadBlob(url, filename) {
  const res = await fetch(url);
  const blob = await res.blob();
  const objectUrl = URL.createObjectURL(blob);

  var a = document.createElement('a');
  a.href = objectUrl;
  a.download = filename;
  a.click();

  URL.revokeObjectURL(objectUrl);      // 記得釋放,否則記憶體不會回收
}

iframe 方案的缺點

它無法掌握下載進度與錯誤。伺服器回 404 時,使用者只會看到一個安靜失敗的 iframe,什麼提示都沒有。此外,若檔案是 PDF 或圖片而伺服器沒設 Content-Disposition,瀏覽器會在隱藏 iframe 中默默載入,使用者完全不知道發生了什麼事。所以除非要維護舊系統,優先選 download 屬性搭配伺服器標頭。

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