萬盛學電腦網

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

jQuery toggle() 方法在 1.9+ 版本失效導致元素隱藏的根因與解決方案

jQuery 1.9 破壞性變更:.toggle(event1, event2...) 移除,綁定後元素消失的真相與修復指南

許多開發者升級 jQuery 至 1.9+ 後發現:原本用 $(elem).toggle(fn1, fn2) 實現的點擊切換功能失效,甚至導致元素直接隱藏。本文深度解析原因,提供三種修復方案與遷移建議。

問題現象

<div id="box">點我切換</div>

<script>
// jQuery 1.8.3 正常運作:點擊輪流執行 fn1、fn2
$('#box').toggle(
    function () { $(this).css('background', 'red'); },
    function () { $(this).css('background', 'blue'); }
);

// jQuery 1.9+ 執行後:#box 直接隱藏 (display:none)!
// 原因:.toggle(fn, fn) 簽名被移除,退回 .toggle() 顯示/隱藏切換
</script>

根因分析

當傳入多個函式時,jQuery 1.9+ 視為無效參數,退回預設行為:立即執行一次顯示/隱藏切換,導致元素隱藏。

官方說明

「.toggle( handler(eventObject), handler(eventObject) [, handler(eventObject) ] ) 簽名已於 jQuery 1.8 棄用,1.9 移除。請改用 .on('click', handler) 配合狀態變數實現。」—— jQuery Core 1.9 Upgrade Guide

修復方案一:計數器模式 (最接近原邏輯、零依賴)

// 原始邏輯重寫
var clickCount = 0;
$('#box').on('click', function () {
    clickCount++;
    if (clickCount % 2 === 1) {
        // 原 fn1 邏輯
        $(this).css('background', 'red');
    } else {
        // 原 fn2 邏輯
        $(this).css('background', 'blue');
    }
});

// 通用封裝:支援 N 個函式輪流執行
$.fn.toggleClick = function (/* fn1, fn2, ... */) {
    var fns = Array.prototype.slice.call(arguments);
    var count = 0;
    return this.on('click', function (e) {
        var fn = fns[count % fns.length];
        fn.call(this, e);
        count++;
    });
};

// 使用
$('#box').toggleClick(
    function () { console.log('第一次點擊'); },
    function () { console.log('第二次點擊'); },
    function () { console.log('第三次點擊'); }
);

修復方案二:布林狀態旗標 (語意更清晰)

var isOn = false;
$('#toggle-btn').on('click', function () {
    isOn = !isOn;
    if (isOn) {
        // 開啟邏輯
        $(this).text('關閉').addClass('active');
        $('#panel').show();
    } else {
        // 關閉邏輯
        $(this).text('開啟').removeClass('active');
        $('#panel').hide();
    }
});

修復方案三:使用 .toggleClass() + CSS (現代最佳實踐)

/* CSS */
#panel { display: none; }
#panel.open { display: block; }
.btn.active { background: #007bff; color: white; }

/* JS */
$('#toggle-btn').on('click', function () {
    $(this).toggleClass('active');
    $('#panel').toggleClass('open');
});

優勢:關注點分離、CSS 動畫支援、狀態可視化、無 JS 變數污染全域。

遷移檢查清單

  1. 全專案搜尋 \.toggle\(function 定位所有舊寫法。
  2. 判斷邏輯類型:單純顯示/隱藏 → 改用 .toggle() / .toggleClass();多函式輪流 → 改用計數器或狀態旗標。
  3. 若專案強依賴舊行為且無法重構,可引入 jQuery Migrate 3.x 臨時相容:
<script src="jquery-3.x.min.js"></script>
<script src="jquery-migrate-3.x.min.js"></script> <!-- 會在 console 警告棄用 API -->

注意:Migrate 只是緩兵之計,長期仍需重構。

延伸:其他 jQuery 1.9+ 破壞性變更

  • .live() / .die() → 改用 .on() / .off() (事件委派)。
  • .andSelf() → 改用 .addBack()。
  • .selector 屬性移除。
  • $.browser 移除 → 用特性檢測或 navigator.userAgent。
  • $.sub() 移除。

總結

jQuery 1.9 移除 .toggle(fn, fn) 是為了精簡核心、推動語意化 API。理解「事件切換」與「顯示切換」兩種 toggle 的語意衝突,選擇適合專案的現代化重寫方式,才能讓代碼庫長期健康演進。

copyright © 萬盛學電腦網 all rights reserved
版本.toggle(fn1, fn2...) 行為.toggle() 行為
≤ 1.8綁定點擊事件,輪流執行傳入函式 (內部用 click 計數器)切換元素顯示/隱藏 (display)
1.9+已移除,不再支援此簽名切換元素顯示/隱藏