DIV CSS 佈局教程網

用 JavaScript 觸發「另存新檔」對話框
編輯:關於JavaScript     

有時候我們不希望圖片直接在瀏覽器裡開啟,而是跳出下載/另存的視窗,讓使用者自行決定要存到哪裡。傳統做法是靠隱藏 iframe 搭配 execCommand("SaveAs")。

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>New Document</title>
<script src="js/jquery.min.js" type="text/javascript"></script>
<script language="JavaScript">
<!--
function downLoadImage(imagePathURL) {
  // 若中間的 IFRAME 不存在,則動態建立一個
  if (!document.getElementById("_SAVEASIMAGE_TEMP_FRAME")) {
    jQuery('<iframe style="display:none;" id="_SAVEASIMAGE_TEMP_FRAME"
             name="_SAVEASIMAGE_TEMP_FRAME"
             onload="_doSaveAsImage();"
             width="0" height="0" src="about:blank"></iframe>')
      .appendTo("body");
  }

  if (document.all._SAVEASIMAGE_TEMP_FRAME.src != imagePathURL) {
    // 圖片網址有變化,重新載入(觸發 onload)
    document.all._SAVEASIMAGE_TEMP_FRAME.src = imagePathURL;
  } else {
    // 網址沒變、已載入完成,直接另存
    _doSaveAsImage();
  }
}

function _doSaveAsImage() {
  if (document.all._SAVEASIMAGE_TEMP_FRAME.src != "about:blank") {
    document.frames("_SAVEASIMAGE_TEMP_FRAME").document.execCommand("SaveAs");
  }
}
//-->
</script>
</head>
<body>
<input type="button" value="download image"
       onclick="downLoadImage('https://www.example.com/images/logo.gif');">
</body>
</html>

這段程式的運作邏輯

流程分兩步。第一次點擊時,程式建立一個 0×0 的隱藏 iframe 並指定圖片網址,等它載完觸發 onload 後,呼叫 _doSaveAsImage() 執行 execCommand("SaveAs")。第二次點擊同一張圖時,因為 src 沒變、iframe 不會重新載入,所以直接呼叫另存函式。

那個 src != imagePathURL 的判斷,處理的就是「網址相同則不會觸發 onload」這個邊界情況。

必須誠實說明的限制

這段程式碼有幾個先天問題,值得先知道再決定要不要用。

它只吃 IE。document.all、document.frames 與 execCommand 都是 IE 專屬,Firefox 與 Chrome 完全無效。execCommand 也早已被標記為 deprecated。

跨來源圖片無效。基於同源政策,你無法用腳本操作不同網域上的資源。

使用者的瀏覽器設定優先。即使跳出對話框,使用者仍可能取消,或瀏覽器根本不顯示。

今天該怎麼做

現代做法乾脆得多。若檔案在你自己網域上,用 download 屬性即可:

<a href="/files/report.pdf" download="報表.pdf">下載報表</a>

需要用 JS 動態觸發時:

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

若是動態產生的內容(例如 canvas 匯出、字串轉檔),先用 Blob 與 URL.createObjectURL() 造出一個暫時網址,再交給上面的函式處理,用完記得呼叫 URL.revokeObjectURL() 釋放。

若資源不在自己網域,正確解法是在後端加一個下載端點:由伺服器讀取該資源、設定 Content-Disposition: attachment 標頭後回傳,前端只需導向這個端點。

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