萬盛學電腦網

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

jQuery 表單驗證提交與序列化完整實戰指南

前言

表單處理是 Web 開發的核心場景。jQuery 提供了多種表單提交與資料序列化方式,從傳統的 .form('submit') 到現代的 AJAX 序列化,各有適用場景。本文將系統梳理三種主流模式,並提供生產級程式碼範例。

模式一:jQuery EasyUI 風格 .form('submit')

適用於 EasyUI 框架專案,支援驗證、提交前攔截、回調處理:

function addSubmit() {
  $('#addForm').form('submit', {
    url: _basePath + '/@Controller/@RequestMapping',
    onSubmit: function() {
      // 1. 自訂業務驗證
      if (!businessCheck()) {
        $.messager.show({ title:'提示', msg:'不符合儲存條件', showType:'fade' });
        return false;  // 阻止提交
      }
      // 2. EasyUI 內建 required 驗證
      return $('#addForm').form('validate');
    },
    success: function(data) {
      var obj = $.parseJSON(data);  // 解析 JSON 回應
      if (!obj.success) {
        $.messager.show({ title:'提示', msg:'儲存失敗', showType:'fade' });
      } else {
        $.messager.show({ title:'提示', msg:'儲存成功', showType:'fade' });
        $('#addWin').window('close');
        query();  // 刷新列表
      }
    }
  });
}

模式二:手動組裝資料 $.get / $.post

早期常見寫法,靈活但冗長:

$('#btn').click(function() {
  $.get('get.php', {
    username: $('#username').val(),
    password: $('#password').val()
  }, function(data, textStatus) {
    $('#target').html(data);
  });
});

模式三:serialize() 序列化 —— 現代標準寫法

核心優勢:自動收集表單所有欄位(含 checkbox、radio、select),自動 URL 編碼,一行搞定。

$('#btn').click(function() {
  $.get('get.php', $('#form').serialize(), function(data, textStatus) {
    $('#target').html(data);
  });
});

進階:serializeArray() 取得陣列物件

回傳 [{name:'username', value:'john'}, {name:'pwd', value:'123'}] 格式,無需 parseJSON,可直接 $.each() 迭代:

var formData = $('#form').serializeArray();
$.each(formData, function(i, field) {
  console.log(field.name + '=' + field.value);
});

實戰最佳實踐:統一表單提交封裝

// 通用 AJAX 表單提交
function submitForm(formId, url, successCallback) {
  var $form = $('#' + formId);
  if (!$form.form('validate')) return;  // EasyUI 驗證

  $.ajax({
    url: url,
    type: 'POST',
    data: $form.serialize(),  // 或 serializeArray()
    dataType: 'json',
    success: function(res) {
      if (res.success) {
        successCallback && successCallback(res);
      } else {
        showError(res.msg || '操作失敗');
      }
    },
    error: function() { showError('網路異常'); }
  });
}

// 使用範例
$('#saveBtn').click(function() {
  submitForm('userForm', '/api/user/save', function(res) {
    $('#userDlg').dialog('close');
    $('#userGrid').datagrid('reload');
  });
});

常見坑點提醒

  • serialize() 不包含 disabled 的欄位 —— 若需提交隱藏 ID,請用 <input type="hidden"> 而非 disabled
  • 檔案上傳 無法 用 serialize(),需使用 FormData + $.ajax({processData:false, contentType:false})
  • 中文內容務必確認頁面與伺服器編碼一致(UTF-8),避免亂碼

總結

現代專案建議以 serialize() / serializeArray() 搭配 $.ajax 為主,配合統一封裝提升開發效率;維護舊專案時才使用 .form('submit')。掌握序列化細節,讓表單處理不再是痛點。

copyright © 萬盛學電腦網 all rights reserved