表單是網頁與後端溝通最古老也最重要的管道。看似簡單,但提交方式有好幾種,行為差異不小,而重複提交更是一個經典的燙手山芋。本文把這些一次整理清楚。
<!-- 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 事件。因此要記得在呼叫前先自行驗證資料,否則等於繞過了你所有的驗證邏輯。
送出表單後若長時間沒有回應,使用者可能會變得不耐煩,於是反覆點擊提交按鈕。結果往往很麻煩(伺服器要處理重複請求),甚至造成錯誤——如果是下訂單,可能就多了好幾筆。
解法有兩個方向:
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>
三個必記重點:
onsubmit 屬性內容一定要有 return 關鍵字,否則函式會直接執行,返回值不會被採用。validateForm 必須回傳 boolean 值。submit 類型。把 form 標籤上的 onsubmit 移除,改為在按鈕上綁定 onclick:
<input type="submit" value="提交" onclick="return validateForm();">
這種寫法有個缺點:使用者按回車鍵送出時不會經過驗證,因為回車觸發的是 form 的 submit 事件而非按鈕的 click。因此實務上仍推薦方法一。
<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 中恢復,這才是完整的防重複提交——只停用而不恢復,一旦失敗使用者就再也送不出去了。表單提交看似基本,但「三種寫法的差異」與「防重複提交的完整性」這兩點,還是能篩出經驗深淺。