萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery ajaxSubmit() 表單非同步提交完整教學

前置準備

ajaxSubmit() 來自 jQuery Form Plugin(jquery.form.js),並非 jQuery 核心功能。使用前需引入:

<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.form/4.3.0/jquery.form.min.js"></script>

基本表單結構

<form id="myForm" action="/api/submit" method="post">
  <label>標題:<input type="text" name="title" /></label><br>
  <label>內容:<textarea name="content"></textarea></label><br>
  <button type="submit">提交</button>
</form>

核心實作程式碼

綁定表單 submit 事件,呼叫 ajaxSubmit() 並處理回應:

$('#myForm').on('submit', function(e) {
  e.preventDefault(); // 阻止預設提交

  $(this).ajaxSubmit({
    type: 'POST',           // 提交方式
    url: '/api/submit',     // 目標 URL(可省略,預設取 form action)
    dataType: 'json',       // 預期回應格式
    data: {                 // 額外資料(選填)
      extra: 'value'
    },
    beforeSubmit: function(arr, $form, options) {
      // 提交前驗證或顯示 loading
      console.log('準備提交', arr);
      return true; // 回傳 false 可取消提交
    },
    success: function(response, statusText, xhr, $form) {
      console.log('提交成功', response);
      alert('提交成功!');
      $form.resetForm(); // 重置表單
    },
    error: function(xhr, statusText, errorThrown) {
      console.error('提交失敗', errorThrown);
      alert('提交失敗,請稍後再試');
    }
  });
});

常用選項說明

選項說明
target指定更新內容的元素選擇器
replaceTarget是否替換目標元素整體(預設 false 僅替換內容)
clearForm提交成功後清空表單
resetForm提交成功後重置表單至初始狀態
semantic是否依 HTML5 語意提交(如 button formaction)

檔案上傳支援

插件自動處理 <input type="file">,無需額外設定。確保表單有 enctype="multipart/form-data" 即可。

注意事項

  • 若頁面有多個表單,請用具體選擇器綁定,避免衝突。
  • 伺服器回應建議回傳 JSON 格式,便於前端處理。
  • 跨域請求需後端設定 CORS 標頭。
copyright © 萬盛學電腦網 all rights reserved