DIV CSS 佈局教程網

form.submit() 無法提交表單的真正原因
編輯:關於JavaScript     

用 JavaScript 呼叫 form.submit() 卻完全沒反應,這種情況通常不是語法寫錯,而是名稱撞了。以下是完整的排查過程。

重現問題的程式碼

<div id="register">
<h4>會員注冊</h4>
<div class="formdiv">
<form method="post" action="register.php?action=register" name="register" id="registerForm">
  <dl>
    <dt>請認真填寫以下內容</dt>
    <dd class="hasspan">用戶名:<input type="text" name="username"></dd>
    <dd class="hasspan">密碼:<input type="password" name="pwd"></dd>
    <dd class="hasspan">確認密碼:<input type="password" name="pwdagain"></dd>
    <dd id="tximg">
      <img src="img/face/m01.gif" alt="選擇頭像" id="faceimg">
      <input type="hidden" name="touxiang" value="">
      <label id="imgsrclabel">m01.gif</label>
    </dd>
    <dd style="margin-right:120px;">
      驗證碼:<input type="text" name="code">
      <span>
        <img src="code.php" alt="code" id="code" name="code">
        <a href="#code" id="change">換一張</a>
      </span>
    </dd>
    <dd class="btns">
      <input type="button" name="submit" id="submit" value="注冊">
      <input type="button" name="quit" id="quit" value="退出">
    </dd>
  </dl>
</form>
</div>
</div>
/* 注冊表單提交 */
function formDeal() {
  var btnSubmit = document.getElementById('submit');
  var formId = document.getElementById('registerForm');
  btnSubmit.onclick = function() {
    formId.submit();     // 這一FAQs行不會有任何反應
  };
}

伺服器端:

if (!empty($_GET['action']) && $_GET['action'] == 'register') {
  echo '你提交了數據';
  exit();
}

測試了很久都沒看到提示,逐行核對並查過官方文件,確認語法沒問題。

真正的原因

關鍵在這一行:

<input type="button" name="submit" id="submit" value="注冊">

這個按鈕的 name 和 id 都叫 "submit"。瀏覽器會把具名的表單控制項掛成表單物件的屬性,於是 formId.submit 拿到的不是那個方法,而是這個 input 元素本身。呼叫 formId.submit() 等同於呼叫一個元素物件,自然什麼都不會發生(嚴格模式下則會拋出 TypeError)。

網路上流傳的兩個說法——「表單中不能有 name="submit" 的標籤」和「表單不能缺少 enctype="multipart/form-data"」——前者方向正確但描述不精確,後者與此問題完全無關。

解決方式

最乾淨的解法是換掉名稱,不要讓控制項遮蔽表單的內建屬性:

<input type="button" name="btnRegister" id="btnRegister" value="注冊">

如果你無法改動 HTML,可以改用 HTMLFormElement 原型上的方法來繞過遮蔽:

HTMLFormElement.prototype.submit.call(formId);

同類型的陷阱

這個問題不只發生在 submit。任何與表單內建屬性或方法同名的控制項,都會造成同樣的遮蔽:

name="action"    → 遮蔽 form.action
name="method"    → 遮蔽 form.method
name="target"    → 遮蔽 form.target
name="reset"     → 遮蔽 form.reset()
name="elements"  → 遮蔽 form.elements
name="length"    → 影響 form.length

因此命名時應避免直接使用這些保留名稱。

這個例子根本不需要 JS

最後值得指出的是,這段程式把 type="button" 加上 onclick 呼叫 submit,繞了一大圈。改成原生就能提交的寫法即可:

<input type="submit" value="注冊">

如果需要先做驗證再決定是否送出,監聽 submit 事件並在驗證失敗時 preventDefault,是更合適的模式:

document.getElementById('registerForm').addEventListener('submit', function (e) {
  if (!validate()) {
    e.preventDefault();     // 阻止送出
  }
});

這樣做的好處是同時涵蓋「按送出按鈕」與「在輸入框按 Enter」兩種途徑,而 onclick 只處理前者。

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