萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 防止 Click 雙擊重複提交並支援動態函數與多參數傳遞

核心問題

當元素同時綁定 click 與 dblclick 事件時,雙擊會觸發兩次 click 再觸發一次 dblclick。若 click 綁定的是提交邏輯,使用者快速雙擊會導致重複提交。本文提供一種通用封裝方案:利用 setTimeout 延遲執行 click 邏輯,若在延遲期間偵測到 dblclick 則取消 click 的執行,同時支援動態綁定、傳遞函數名稱與多參數。

事件觸發順序分析

  • 單擊:mousedown → mouseup → click
  • 雙擊:mousedown → mouseup → click → mousedown → mouseup → click → dblclick
  • 瀏覽器會屏蔽雙擊中第一次的 click,但第二次 click 仍會執行,導致 click 與 dblclick 皆被觸發。

解決方案:延遲執行 + 雙擊取消

核心邏輯

function std(obj, vs) {
    var TimeFn = null;
    // 取得元素原本的 onclick 字串(如 "ss1('DIV事件')")
    var funs = $(obj).attr("onclick");

    $(obj).click(function() {
        clearTimeout(TimeFn);
        TimeFn = setTimeout(function() {
            eval(funs);          // 執行原本的 onclick 邏輯
            clearTimeout(TimeFn);
        }, 400);                 // 400ms 延遲,可依需求調整
    });

    $(obj).dblclick(function() {
        clearTimeout(TimeFn);    // 雙擊時取消待執行的 click
    });

    $(obj).removeAttr("onclick"); // 移除內聯 onclick,改由 jQuery 統一管理
}

使用範例

<div id="div" onclick="ss1('DIV事件')" style="background:#f60;color:#fff;width:80px;padding:10px 20px;">點擊我吧</div>
<input type="button" id="but1" onclick="ss2('INPUT事件')" value="按鈕一" />

<script>
// 定義業務函數
var ss1 = function(s) { $("#show").html("DIV顯示測試結果:" + s); alert("a"); };
var ss2 = function(s) { $("#show").html("INPUT顯示測試結果:" + s); alert("b"); };

// 動態綁定
std("#div", "div");
std("#but1", "button1");
</script>

進階:支援多參數與動態函數

上述範例透過 eval(funs) 執行字串形式的函數呼叫,實際專案中建議改用 data-* 屬性存放函數名與參數,配合 Function.prototype.apply 或 call 執行,避免 eval 安全風險。範例架構如下:

<button data-fn="submitForm" data-args='["arg1", "arg2"]'>提交</button>

$('button').each(function() {
    var $this = $(this),
        fnName = $this.data('fn'),
        args   = $this.data('args') || [];

    $this.click(function() {
        clearTimeout(TimeFn);
        TimeFn = setTimeout(function() {
            if (typeof window[fnName] === 'function') {
                window[fnName].apply(null, args);
            }
        }, 300);
    }).dblclick(function() { clearTimeout(TimeFn); });
});

注意事項

  1. 延遲時間:300~500ms 為常見折衷,太短易誤判雙擊,太長體驗延遲感明顯。
  2. 行動裝置:觸控裝置無雙擊事件,需額外處理 touchend 邏輯或直接停用此機制。
  3. 無障礙:確保鍵盤操作(Enter/Space)同樣受保護,必要時監聽 keydown。

總結

透過 setTimeout 延遲 click 執行並在 dblclick 中清除計時器,即可有效防止雙擊導致的重複提交。封裝成通用函數 std() 後,可動態綁定任意元素、支援函數名與參數傳遞,大幅提升程式碼複用性與維護性。

copyright © 萬盛學電腦網 all rights reserved