表單重複提交是個老問題,但造成的後果往往不小:重複的訂單、多筆重複的資料、甚至資料庫唯一鍵衝突。以下幾個做法可以搭配使用。
如果表單是透過 onsubmit 走 Ajax 提交,那把 input 的 type 設為 button 而非 submit,就能避開瀏覽器原生的表單送出流程,少一層干擾。
網路延遲時,使用者很可能以為沒反應而反覆點擊。在 onclick 中立刻把按鈕設為 disabled:
$(this).attr('disabled', 'disabled');
較通用的寫法是攔住整個表單的 submit,把裡面的送出按鈕全部禁用:
$("form").submit(function(){
$(":submit", this).attr("disabled", "disabled");
});
這裡的第二個參數 this 很重要——它限定搜尋範圍在當前表單內,避免同一頁有多個表單時誤傷其他按鈕。
單純禁用按鈕有個漏洞:使用者在文字欄位中按 Enter 一樣會觸發 submit,而這時焦點不在按鈕上。用一個旗標來守衛整個流程會更穩妥:
var submitting = false;
$('#myForm').submit(function(e){
e.preventDefault(); // 先攔下原生送出
if(submitting){ // 已在處理中,直接忽略這次觸發
return false;
}
submitting = true;
$(this).find(':submit').prop('disabled', true);
$.ajax({
url: '/api/submit',
type: 'POST',
data: $(this).serialize(),
success: function(res){
// 處理成功後的畫面
},
complete: function(){
// 無論成功或失敗都要解鎖,否則使用者再也無法送出
submitting = false;
$('#myForm').find(':submit').prop('disabled', false);
}
});
});
幾個實務上的細節。
用 prop('disabled', true) 而非 attr。從 jQuery 1.6 起,disabled 這類布林屬性應該用 prop 設定,attr 在後續版本中的行為已不一致。
complete 回呼一定要解鎖。如果只在 success 裡解鎖,請求失敗時按鈕就會永遠卡在禁用狀態,使用者再也無法重試。
前端攔截只是第一道防線。使用者可以禁用 JavaScript、直接呼叫 API,或刻意重送請求,因此後端仍應具備冪等性設計——例如用 requestId 去重、在資料庫層加上唯一鍵約束,或搭配 token 機制。把前端禁用當成唯一手段,遲早會出問題。