DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> WEB網站前端 >> 前端技巧
圖片按鈕導致表單重複提交的陷阱與解法
編輯:前端技巧     

很多時候為了美化表單,會把提交按鈕換成一張圖片。但如果沒注意細節,這可能導致表單被送出兩次,產生一些莫名其妙的錯誤——例如重複寫入資料庫記錄。

這個問題曾讓我実際に翻船:使用者登入時的圖形驗證碼怎麼驗都錯。原因很簡單——表單被送出了兩次,第二次的驗證碼當然對不上。

正確的寫法

<form id="loginform" name="loginform" action="https://example.com/login.php" method="get">
  <input name="name" />
  <input type="image" src="login.gif" name="imagesubmit" />
</form>

這段程式碼是正確的,不會有重複送出的問題。<input type="image"> 其實和 <input type="submit"> 起到的作用完全相同——點擊圖片就會執行 submit 操作。

錯誤的寫法

但有些人不放心,畫蛇添足地幫 image 加了一個 onclick:

<form id="loginform" name="loginform" action="https://example.com/login.php" method="get">
  <input name="name" />
  <input onclick="document.loginform.submit()" type="image" src="login.gif" name="imagesubmit" />
</form>

这下子點一次圖片按鈕就送出兩次了,重複提交由此產生。其功能相當於:

<input type="submit" onclick="submit()">

顯然不對。問題的根源是:type="image" 本身已經會送出表單,你又額外呼叫了一次 submit()。

解法一:改用 <img>

如果一定要用 onclick 事件,可以用 <img> 取代 <input type="image">,因為 img 本身沒有送出表單的行為:

<form id="loginform" name="loginform" action="https://example.com/login.php" method="get">
  <input name="name" />
  <img onclick="document.loginform.submit()" src="login.gif" name="imagesubmit" />
</form>

如何禁止重複提交

針對 <input type="image" onclick="submit()"> 這種寫法,最簡單的解法是在送出後停用該按鈕:

<input type="image" src="bt.gif" onclick="submit();this.disabled=true">

但如果是多個按鈕並排,希望點其中一個之後全部都不能再送,可以用迴圈一次停用:

<script language="JavaScript">
function test() {
  var btns = document.getElementsByName('t1');
  for (var i = 0; i < btns.length; i++) {
    btns[i].disabled = true;
  }
}
</script>

<form name="f1" method="post" action="1.htm" target="_blank" onsubmit="test()">
  <input type="image" name="t1" src="newtopic.gif">
  <input type="image" name="t1" src="newtopic.gif">
  <input type="image" name="t1" src="newtopic.gif">
</form>

用圖片提交表單的兩種方式比較

方式一:<input type="image">

<input type="image" src="xxx.gif">

此圖片會自動對表單進行送出,等同 type="submit"。若送出前要進行判斷、檢驗:

<input type="image" src="xxx.gif" onclick="return dosubmit();">

問題:用這種方式送出會發生表單送出兩次的現象,經常造成表單元素被重複提交、資料庫寫入異常。尤其在 IE 上問題比較嚴重,Firefox 反而不會報錯(但不代表沒送出兩次)。

原因:HTML 中 image 的描述是「創建一個圖像控制項,該控制項單擊後將導致表單立即被提交」。它天生就會送出,不需要也不應該再呼叫 submit()。

方式二:<img>

<img alt="提交" src="xxx.gif" onclick="return dosubmit();" style="cursor:pointer;">

這種方式送出是正常的,沒有問題,效果與上面相同。所以請盡量用這種方式提交資料。

注意:CSS 的 cursor:hand 只能被 IE 識別,Firefox 不認;而 pointer 則可以相容各瀏覽器。

另外:無論用哪種方式提交,都必須包含在 <form></form> 之間,否則送出無效。

現代最佳實踐

今天的正解很單純:用 <button> 搭配 CSS,讓它看起來像圖片,但語義上是按鈕。

<form id="loginform" action="/login" method="post">
  <input name="name" aria-label="帳號">
  <button type="submit" class="btn-image">
    <img src="login.gif" alt="登入">
  </button>
</form>

<style>
.btn-image {
  border: 0;
  padding: 0;
  background: none;
  cursor: pointer;
}
</style>

這樣做的好處:

  • 只有一次送出 — button 的 submit 行為單一明確,不會重複。
  • 可用鍵盤操作 — <img> 無法用 Tab 聚焦、無法用 Enter 觸發,<button> 天生具備這些能力,這是無障礙的關鍵。
  • 能被螢幕閱讀器辨識為按鈕 — 而 <img onclick> 只會被讀成一張圖片。
  • 可用 CSS 控制 hover / focus / disabled 狀態 — 不必靠 JS 改 style。

防重複提交也變得乾淨:

form.addEventListener('submit', async function (e) {
  e.preventDefault();
  const btn = this.querySelector('button[type="submit"]');
  btn.disabled = true;               // 立刻鎖住,避免連續點擊
  try {
    await fetch(this.action, { method: this.method, body: new FormData(this) });
  } finally {
    btn.disabled = false;
  }
});

最後一定要說的一件事

前端防重複提交只是使用者體驗,不是資料正確性的保證。使用者可以禁用 JS、可以重送請求、網路可以重試。真正的防線必須在後端:

  • 資料庫加上唯一性約束(UNIQUE INDEX),重複寫入會直接被拒。
  • 表單帶一個一次性 token(如 CSRF token 兼作冪等鍵),伺服器驗證後立即作廢。
  • 關鍵操作(付款、下單)採用冪等鍵(Idempotency-Key),重複請求回傳相同結果而非再執行一次。

這個「圖片按鈕送出兩次」的 bug 之所以經典,正是因為它同時說明了三件事:HTML 元素的預設行為要弄清楚、無障礙不該被犧牲、前端驗證永遠不能取代後端驗證。

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