DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> WEB網站前端 >> 前端技巧
網頁表單提交方式完整彙總:從 submit 按鈕到程式化提交
編輯:前端技巧     

表單是網頁與後端溝通最古老也最重要的管道。看似簡單,但提交方式有好幾種,行為差異不小,而重複提交更是一個經典的燙手山芋。本文把這些一次整理清楚。

一、五種提交按鈕的寫法

<!-- 1. 通用提交按鈕 -->
<input type="submit" value="提交">

<!-- 2. 自定義樣式的提交按鈕 -->
<button type="submit">提交</button>

<!-- 3. 圖像按鈕 -->
<input type="image" src="btn.png">

說明:使用者點擊提交按鈕或圖像按鈕時,表單就會送出。用 <input> 或 <button> 都能定義提交按鈕,只要把 type 設為 submit;圖像按鈕則是把 type 設為 image。

<input> 與 <button> 該選哪個?

  • <input type="submit"> 只能放文字,無法包含 HTML。
  • <button> 可以包含圖示、多行文字等 HTML 內容,樣式彈性大得多。
  • 注意:<button> 若不指定 type,預設值是 submit,這在表單中容易造成意料之外的送出行為。請 ALWAYS 明確加上 type="button" 或 type="submit"。

二、關於回車鍵送出

只要表單中存在上述任一種按鈕,那麼在表單控制項擁有焦點時按回車鍵,就能送出表單。如果表單裡沒有提交按鈕,按回車不會送出。

這也是為什麼搜尋框那類只有一個文字輸入的表單,即使沒有 submit 按鈕也能用回車送出——瀏覽器對單一文字欄位的表單有特別處理。

三、阻止表單提交

以這種方式送出時,瀏覽器會在把請求送往伺服器之前觸發 submit 事件。這給了我們驗證資料、決定是否允許送出的機會。阻止這個事件的預設行為,就能取消提交:

var EventUtil = {
  addHandler: function (element, type, handler) {
    if (element.addEventListener) {
      element.addEventListener(type, handler, false);
    } else if (element.attachEvent) {
      element.attachEvent("on" + type, handler);
    } else {
      element["on" + type] = handler;
    }
  },
  getEvent: function (event) {
    return event ? event : window.event;
  },
  preventDefault: function (event) {
    if (event.preventDefault) {
      event.preventDefault();
    } else {
      event.returnValue = false;
    }
  }
};

var form = document.getElementById("myForm");
EventUtil.addHandler(form, "submit", function (event) {
  event = EventUtil.getEvent(event);
  EventUtil.preventDefault(event);   // 阻止表單送出
});

一般來說,在表單資料無效、不能送往伺服器時,就會用這招攔下來。

四、程式化提交

在 JavaScript 中直接呼叫 submit() 方法也能送出表單。這種方式不需要表單包含提交按鈕,任何時候都能用:

var form = document.getElementById("myForm");
form.submit();

關鍵差異:以呼叫 submit() 方法的形式送出時,不會觸發 submit 事件。因此要記得在呼叫前先自行驗證資料,否則等於繞過了你所有的驗證邏輯。

五、重複提交:最惱人的問題

送出表單後若長時間沒有回應,使用者可能會變得不耐煩,於是反覆點擊提交按鈕。結果往往很麻煩(伺服器要處理重複請求),甚至造成錯誤——如果是下訂單,可能就多了好幾筆。

解法有兩個方向:

  1. 第一次送出後就停用提交按鈕。
  2. 利用 onsubmit 事件處理器取消後續的送出動作。

六、三種表單提交方法詳解

方法一:form 的 onsubmit(最常用)

<script type="text/javascript">
function validateForm() {
  // 透過 form 名稱取得表單
  if (document.reply.title.value == "") {
    alert("請輸入標題!");
    document.reply.title.focus();
    return false;
  }
  // 透過 forms 陣列取得表單
  if (document.forms[0].cont.value == "") {
    alert("請輸入內容!");
    document.reply.cont.focus();
    return false;
  }
  return true;
}
</script>

<form name="reply" method="post" onsubmit="return validateForm();">
  <input type="text" name="title" size="80" />
  <textarea name="cont" cols="80" rows="12"></textarea>
  <input type="submit" value="提交">
</form>

三個必記重點:

  1. onsubmit 屬性內容一定要有 return 關鍵字,否則函式會直接執行,返回值不會被採用。
  2. validateForm 必須回傳 boolean 值。
  3. 提交按鈕必須是 submit 類型。

方法二:submit 按鈕的 onclick

把 form 標籤上的 onsubmit 移除,改為在按鈕上綁定 onclick:

<input type="submit" value="提交" onclick="return validateForm();">

這種寫法有個缺點:使用者按回車鍵送出時不會經過驗證,因為回車觸發的是 form 的 submit 事件而非按鈕的 click。因此實務上仍推薦方法一。

方法三:button 的 onclick + 手動送出

<script type="text/javascript">
function modifyItem() {
  if (trim(document.getElementById("itemName").value) == "") {
    alert("物料名稱不能為空!");
    document.getElementById("itemName").focus();
    return;
  }
  with (document.getElementById("itemForm")) {
    method = "post";
    action = "item.do?command=modify&pageNo=${itemForm.pageNo}";
    submit();
  }
}

function goBack() {
  window.self.location = "item.do?command=list&pageNo=${itemForm.pageNo}";
}
</script>

<form name="itemForm" id="itemForm">
  <input name="itemNo" type="text" id="itemNo" value="${item.itemNo}">
  <input name="itemName" type="text" id="itemName" value="${item.itemName}">
  <input name="btnModify" type="button" id="btnModify" value="修改" onclick="modifyItem()">
</form>

注意這裡用的是 type="button"(純按鈕,不自動送出),在 JS 中設定好 action 與 method 後再呼叫 submit()。這種寫法讓你在送出前能做任意複雜的處理,彈性最高。

菜鳥小結與現代建議

當時的經驗:對 form 中的元件做驗證時,前兩種方法使用的是 name 屬性(包括 form 自身的)。如果送出表單時沒有反應,而確定提交部分的程式碼沒問題,請檢查前面的 JS 程式碼——有時前面的錯誤會引發莫名其妙的後果。

今天的標準做法:

<form id="myForm" novalidate>
  <input type="text" name="title" required aria-label="標題">
  <textarea name="cont" required aria-label="內容"></textarea>
  <button type="submit">提交</button>
</form>

<script>
const form = document.getElementById('myForm');

form.addEventListener('submit', function (e) {
  e.preventDefault();               // 一律先攔下,改用 fetch 送出

  if (!form.reportValidity()) return;   // 使用瀏覽器原生驗證

  const data = Object.fromEntries(new FormData(form));

  // 防重複提交
  const btn = form.querySelector('button[type="submit"]');
  btn.disabled = true;

  fetch('/api/submit', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(data)
  })
  .then(r => r.json())
  .then(res => alert('成功'))
  .catch(err => alert('失敗:' + err))
  .finally(() => { btn.disabled = false; });
});
</script>

幾個關鍵升級:

  • 用 required、type="email" 等 HTML5 原生驗證取代手寫 if,程式碼更少、無障礙支援更好、手機鍵盤也會自動切換。
  • 用 fetch 取代傳統頁面跳轉送出,能保留當前頁面狀態、提供即時回饋。
  • 送出期間停用按鈕,並在 finally 中恢復,這才是完整的防重複提交——只停用而不恢復,一旦失敗使用者就再也送不出去了。
  • 後端仍需驗證,前端驗證只是為了改善體驗。真正的防重複提交必須靠伺服器端的冪等鍵(idempotency key)或資料庫唯一性約束。

表單提交看似基本,但「三種寫法的差異」與「防重複提交的完整性」這兩點,還是能篩出經驗深淺。

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