DIV CSS 佈局教程網

用 JS 實作網頁上的檔案下載按鈕
編輯:關於JavaScript     

很多時候我們需要在頁面上放一個下載鈕,讓使用者點一下就取得檔案。實作方式有兩種,取決於檔案是靜態資源還是需要向後端請求。

前置準備:加入下載圖示

這裡用的圖示來自 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 標頭,否則瀏覽器可能只會把內容顯示出來而不下載。

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