很多時候我們需要在頁面上放一個下載鈕,讓使用者點一下就取得檔案。實作方式有兩種,取決於檔案是靜態資源還是需要向後端請求。
這裡用的圖示來自 font-awesome。先把整個 font-awesome 資料夾放進專案(可用 bower 或直接從官網下載),再於頁面引入樣式檔:
<link href="libs/font-awesome-4.7.0/css/font-awesome.min.css" type="text/css" rel="stylesheet">
之後就能使用圖示了:
<i class="fa fa-download" aria-hidden="true" title="下載"></i>
如果只是要提供一個 Excel 範本檔,把檔案放進專案目錄,然後在圖示上掛 onclick 開啟它即可:
<i class="fa fa-download" aria-hidden="true" title="下載"
onclick="window.open('file/user.xlsx')"></i>
點擊後檔案就會下載。
jQuery 的 ajax() 回傳型別只有 xml、text、json、html 等,沒有「檔案流」,所以無法直接用它下載檔案。常見的解法是動態建立一個 form 並提交,讓瀏覽器原生處理回應;由於目標不是新視窗,頁面本身不會刷新。
GET 請求
$('.download').click(function () {
var tt = new Date().getTime();
var url = 'https://192.168.1.231:8080/91survey/ws/excel/download';
/**
* 用 form 表單發送請求
* 1. method 決定請求類型(post 或 get)
* 2. action 決定請求路徑
*/
var form = $("<form>");
form.attr("style", "display:none");
form.attr("target", "");
form.attr("method", "get");
form.attr("action", url);
$("body").append(form);
/**
* 用隱藏的 input 傳遞參數:
* 1. name 是參數名,value 是參數值
* 2. GET 時參數必須用 input 傳,直接接在 URL 後面無效
* 3. POST 時 queryString 可接在 URL 後,其餘用 input 傳
*/
var input1 = $("<input>");
input1.attr("type", "hidden");
input1.attr("name", "tt");
input1.attr("value", tt);
form.append(input1);
var input2 = $("<input>");
input2.attr("type", "hidden");
input2.attr("name", "companyId");
input2.attr("value", companyId);
form.append(input2);
form.submit();
});
POST 請求
$('.download').click(function () {
var tt = new Date().getTime();
var url = restUrl + '/excel/download?userId=' + userId;
var form = $("<form>");
form.attr("style", "display:none");
form.attr("target", "");
form.attr("method", "post");
form.attr("action", url);
$("body").append(form);
var input1 = $("<input>");
input1.attr("type", "hidden");
input1.attr("name", "tt");
input1.attr("value", tt);
form.append(input1);
var input2 = $("<input>");
input2.attr("type", "hidden");
input2.attr("name", "companyId");
input2.attr("value", companyId);
form.append(input2);
form.submit();
});
完成後點擊下載圖示,檔案便會自動下載。
補充一個現代瀏覽器都支援的簡便寫法:若檔案是同源資源,直接用 <a href="file/user.xlsx" download="user.xlsx"> 就能觸發下載,不必繞道 form。真正需要 form 提交的原因,通常是要帶上驗證資訊或較複雜的查詢參數;這種情況下,記得在後端設定好 Content-Disposition 標頭,否則瀏覽器可能只會把內容顯示出來而不下載。