很多時候為了美化表單,會把提交按鈕換成一張圖片。但如果沒注意細節,這可能導致表單被送出兩次,產生一些莫名其妙的錯誤——例如重複寫入資料庫記錄。
這個問題曾讓我実際に翻船:使用者登入時的圖形驗證碼怎麼驗都錯。原因很簡單——表單被送出了兩次,第二次的驗證碼當然對不上。
<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()。
如果一定要用 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" src="xxx.gif">
此圖片會自動對表單進行送出,等同 type="submit"。若送出前要進行判斷、檢驗:
<input type="image" src="xxx.gif" onclick="return dosubmit();">
問題:用這種方式送出會發生表單送出兩次的現象,經常造成表單元素被重複提交、資料庫寫入異常。尤其在 IE 上問題比較嚴重,Firefox 反而不會報錯(但不代表沒送出兩次)。
原因:HTML 中 image 的描述是「創建一個圖像控制項,該控制項單擊後將導致表單立即被提交」。它天生就會送出,不需要也不應該再呼叫 submit()。
<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>
這樣做的好處:
<img> 無法用 Tab 聚焦、無法用 Enter 觸發,<button> 天生具備這些能力,這是無障礙的關鍵。<img onclick> 只會被讀成一張圖片。防重複提交也變得乾淨:
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、可以重送請求、網路可以重試。真正的防線必須在後端:
這個「圖片按鈕送出兩次」的 bug 之所以經典,正是因為它同時說明了三件事:HTML 元素的預設行為要弄清楚、無障礙不該被犧牲、前端驗證永遠不能取代後端驗證。