DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML和Xhtml
表單上傳檔案卻不想跳頁:三種非同步思路
編輯:HTML和Xhtml     

最常見的表單寫法如下:

<form action="/hehe" method="post">
  <input type="text" value="hehe"/>
  <input type="submit" value="upload" id="upload"/>
</form>

這種方式一定會換頁。有些時候我們希望在當前頁面就完成與伺服器的互動,送完表單後不要跳走。以下三種做法,從最取巧到最正統。

思路一:把表單送進隱藏 iframe(曲線救國)

上面的程式碼完全不用改,只要補一個 iframe:

<iframe id="uploadFrame" name="uploadFrame"></iframe>

並在 form 上加上 target 屬性,讓 target 值與 iframe 的 name(或 id)一致:

<form action="/hehe" method="post" target="uploadFrame">

原理是:表單其實還是刷新了,只是刷新發生在那個看不見的 iframe 裡,對使用者來說就跟沒刷新一樣,於是產生了「非同步」的錯覺。

這不是正統做法,限制也很明顯——如果你需要在完成後取回伺服器回傳的內容,這招就完全無效。

思路二:用 jQuery 的上傳外掛

這裡以 ajaxupload 為例,使用方式相當簡單:

<body>
<form action="/hehe" method="post">
  <input type="text" value="hehe"/>
  <input type="button" value="upload" id="upload"/>
</form>
<script>
(function(){
  new AjaxUpload("#upload", {
    action: '/hehe',
    type: "post",
    data: {},
    name: 'textfield',
    onSubmit: function(file, ext) {
      alert("上傳成功");
    },
    onComplete: function(file, response) {
      // 在這裡處理伺服器回傳的資料
    }
  });
})();
</script>
</body>

頁面渲染完成後,用一個立即執行的函式幫 id 為 upload 的按鈕掛上非同步上傳行為。new AjaxUpload(id, options) 的第一個參數是要綁定的元素 id;第二個參數中,data 是附帶的額外資料,name 可自訂,onSubmit 是上傳前的回呼(file 是檔名、ext 是副檔名),onComplete 則能拿到伺服器回傳的內容。

思路三:用標準的非同步 API(今日首選)

現在不需要外掛,瀏覽器原生的 FormData 加上 fetch 就能完成,而且能真正處理回應:

const form = document.querySelector('form');

form.addEventListener('submit', async (e) => {
  e.preventDefault();               // 阻止表單的預設跳頁行為

  const res = await fetch('/hehe', {
    method: 'POST',
    body: new FormData(form)       // 一次帶上所有欄位與檔案
  });

  const data = await res.json();   // 伺服器記得回 JSON
  console.log(data);
});

若要顯示上傳進度,改用 XMLHttpRequest 並監聽 upload.onprogress 事件,因為 fetch 目前不支援上傳進度回報。

選擇建議

思路一可以作為理解歷史的知識,思路二適用在維護既有 jQuery 專案,而新專案請直接用 FormData 加 fetch:程式碼更少、能拿到完整回應、錯誤處理也清楚得多。

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