有時候我們不希望圖片直接在瀏覽器裡開啟,而是跳出下載/另存的視窗,讓使用者自行決定要存到哪裡。傳統做法是靠隱藏 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 標頭後回傳,前端只需導向這個端點。