萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

jQuery Form Plugin:ajaxForm 與 ajaxSubmit 完整範例與差異解析

引言

jQuery Form Plugin 讓表單以 AJAX 方式提交變得極簡單,核心提供兩個方法:

  • ajaxForm(options):綁定表單 submit 事件,自動攔截並 AJAX 提交。
  • ajaxSubmit(options):手動觸發 AJAX 提交,適合按鈕非 type="submit" 或需額外驗證邏輯。

完整可執行範例(單一 HTML)

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>jQuery Form Plugin Demo</title>
  <script src="https://code.jquery.com/jquery-1.12.4.min.js"></script>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.form/4.3.0/jquery.form.min.js"></script>
</head>
<body>
  <h3>方式一:ajaxForm 自動綁定</h3>
  <form id="form1" action="chuli.php" method="post">
    <input name="name" placeholder="姓名">
    <input name="sex" placeholder="性別">
    <button type="submit">提交</button>
  </form>

  <h3>方式二:ajaxSubmit 手動觸發</h3>
  <form id="form2" action="chuli.php" method="post">
    <input name="name" placeholder="姓名">
    <input name="sex" placeholder="性別">
    <button type="button" id="btnSubmit">提交</button>
  </form>

  <script>
    // ajaxForm:宣告式選項
    $('#form1').ajaxForm({
      dataType: 'json',
      beforeSubmit: function(arr, $form, opts) {
        console.log('form1 送出前', arr);
        return true; // 回傳 false 可取消提交
      },
      success: function(data, status, xhr, $form) {
        alert('form1 成功:' + JSON.stringify(data));
      },
      error: function(xhr, status, err) {
        alert('form1 失敗:' + err);
      },
      clearForm: true,
      resetForm: true
    });

    // ajaxSubmit:命令式呼叫
    $('#btnSubmit').click(function() {
      $('#form2').ajaxSubmit({
        dataType: 'json',
        success: function(data) {
          alert('form2 成功:' + JSON.stringify(data));
        },
        error: function(xhr, status, err) {
          alert('form2 失敗:' + err);
        }
      });
    });
  </script>
</body>
</html>

核心選項速查

選項型別預設說明
urlStringform.action提交目標網址
type / methodStringform.methodHTTP 方法 GET/POST
dataTypeString'auto'預期回傳格式:json, xml, script, html, text
beforeSubmitFunctionnull提交前回調,回傳 false 取消
successFunctionnull成功回調 (data, status, xhr, $form)
errorFunctionnull失敗回調 (xhr, status, error)
completeFunctionnull完成回調(成功/失敗皆執行)
clearFormBooleanfalse成功後清空表單輸入值
resetFormBooleanfalse成功後重置表單至初始狀態
iframeBooleanfalse檔案上傳時設 true(內部用隱藏 iframe 模擬 AJAX)
forceSyncBooleanfalse強制同步模式(不建議)

檔案上傳專用設定

$('#uploadForm').ajaxSubmit({
  dataType: 'json',
  iframe: true,          // 必須啟用
  // 或使用 FormData (現代瀏覽器)
  // processData: false,
  // contentType: false,
  success: function(res) { console.log(res); }
});

進階技巧

  • 驗證整合:beforeSubmit 整合 jQuery Validation:return $form.valid();
  • 上傳進度:Plugin 4.0+ 支援 uploadProgress 事件(需瀏覽器支援 XHR2)。
  • 多檔案:<input type="file" name="files[]" multiple>,後端接收陣列。
  • 取消提交:儲存 xhr 物件(beforeSerialize 或 beforeSubmit 回調中取得),稍後呼叫 xhr.abort()。
copyright © 萬盛學電腦網 all rights reserved