萬盛學電腦網

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

JavaScript 表單提交攔截:onSubmit 返回值控制、AJAX 提交、防重複提交最佳實踐

核心機制

<form onsubmit="return handler()"> 中,handler 返回 false 可**阻止默認提交**;返回 true 或無返回值則繼續提交。這是表單攔截的最基礎語法。

基礎模式

<form id="regForm" onsubmit="return validateAndSubmit()">
  <input name="username" required>
  <input name="password" type="password" required>
  <button type="submit">註冊</button>
</form>

<script>
function validateAndSubmit() {
  var form = document.getElementById('regForm');
  if (!form.checkValidity()) {
    form.reportValidity(); // 顯示瀏覽器原生提示
    return false; // 阻止提交
  }
  // 這裡可做額外同步檢查
  return true; // 允許提交
}
</script>

現代模式:事件監聽器 + preventDefault + fetch

<form id="regForm" novalidate> <!-- 關閉原生氣泡,自定義 UI -->
  <div class="field">
    <label for="username">用戶名</label>
    <input type="text" id="username" name="username" required minlength="3" maxlength="16">
    <span class="error" aria-live="polite"></span>
  </div>
  <button type="submit" class="btn-submit">提交</button>
</form>

<script>
var form = document.getElementById('regForm');
var submitBtn = form.querySelector('.btn-submit');

form.addEventListener('submit', function (e) {
  e.preventDefault(); // 永遠阻止默認跳轉

  // 1. 驗證
  if (!form.checkValidity()) {
    showErrors(form);
    return;
  }

  // 2. 防重複提交
  if (submitBtn.disabled) return;
  submitBtn.disabled = true;
  submitBtn.textContent = '提交中...';

  // 3. 收集數據
  var formData = new FormData(form);

  // 4. AJAX 提交
  fetch(form.action || '/api/register', {
    method: form.method || 'POST',
    body: formData,
    credentials: 'same-origin' // 攜帶 Cookie
  })
  .then(function (res) {
    if (!res.ok) throw new Error('HTTP ' + res.status);
    return res.json();
  })
  .then(function (data) {
    if (data.success) {
      showToast('註冊成功,跳轉中...');
      setTimeout(function () { location.href = data.redirect || '/'; }, 1500);
    } else {
      showFieldError(form.querySelector('[name="username"]'), data.message || '註冊失敗');
    }
  })
  .catch(function (err) {
    console.error(err);
    showToast('網絡錯誤,請重試');
  })
  .finally(function () {
    submitBtn.disabled = false;
    submitBtn.textContent = '提交';
  });
});

function showErrors(form) {
  form.querySelectorAll(':invalid').forEach(function (el) {
    var err = el.parentNode.querySelector('.error');
    if (err) err.textContent = el.validationMessage;
    el.style.borderColor = '#dc3545';
  });
  form.querySelector(':invalid').focus();
}

function showFieldError(el, msg) {
  var err = el.parentNode.querySelector('.error');
  if (err) err.textContent = msg;
  el.style.borderColor = '#dc3545';
  el.focus();
}

function showToast(msg) {
  // 簡易 Toast 實現
  var t = document.createElement('div');
  t.textContent = msg;
  t.style.cssText = 'position:fixed;bottom:20px;left:50%;transform:translateX(-50%);background:#333;color:#fff;padding:12px 24px;border-radius:4px;z-index:9999';
  document.body.appendChild(t);
  setTimeout(function () { t.remove(); }, 3000);
}
</script>

進階:`requestSubmit()` 觸發原生驗證流程

<button type="button" id="customSubmit">自定義提交按鈕</button>

<script>
document.getElementById('customSubmit').addEventListener('click', function () {
  // 觸發表單驗證 + submit 事件,等同用戶點擊 type=submit
  form.requestSubmit();
});
</script>
  • 優於 form.submit():後者**跳過驗證**、不觸發 submit 事件
  • 支援:Chrome 76+, Firefox 69+, Safari 15.4+, Edge 79+

文件上傳表單特殊處理

<form id="uploadForm" enctype="multipart/form-data">
  <input type="file" name="avatar" accept="image/*" required>
  <progress id="progress" value="0" max="100" hidden></progress>
  <button type="submit">上傳</button>
</form>

<script>
document.getElementById('uploadForm').addEventListener('submit', function (e) {
  e.preventDefault();
  var formData = new FormData(this);
  var xhr = new XMLHttpRequest(); // fetch 無法監聽上傳進度

  xhr.upload.addEventListener('progress', function (e) {
    if (e.lengthComputable) {
      var percent = Math.round(e.loaded / e.total * 100);
      document.getElementById('progress').value = percent;
      document.getElementById('progress').hidden = false;
    }
  });

  xhr.addEventListener('load', function () {
    if (xhr.status >= 200 && xhr.status < 300) {
      alert('上傳成功');
    } else {
      alert('上傳失敗: ' + xhr.status);
    }
  });

  xhr.open('POST', this.action);
  xhr.send(formData);
});
</script>

防重複提交:多層防護

層級方案代碼關鍵點
UI 層按鈕 disabled + Loading 狀態btn.disabled = true
邏輯層標誌位鎖if (submitting) return; submitting = true;
業務層冪等性 Key(如訂單號)後端 SETNX order:123 lock
網絡層幂等請求頭 Idempotency-KeyStripe/AWS 模式

結語

表單提交攔截的核心是 **`e.preventDefault()` + 異步 `fetch`/`XMLHttpRequest`**。掌握 checkValidity()/reportValidity() 原生驗證、requestSubmit() 觸發標準流程、FormData 自動序列化、上傳進度監聽、多層防重機制,即可構建企業級表單交互體驗。

copyright © 萬盛學電腦網 all rights reserved