| 版本 | .toggle(fn1, fn2...) 行為 | .toggle() 行為 |
| ≤ 1.8 | 綁定點擊事件,輪流執行傳入函式 (內部用 click 計數器) | 切換元素顯示/隱藏 (display) |
| 1.9+ | 已移除,不再支援此簽名 | 切換元素顯示/隱藏 |
當傳入多個函式時,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 變數污染全域。
遷移檢查清單
- 全專案搜尋
\.toggle\(function 定位所有舊寫法。
- 判斷邏輯類型:單純顯示/隱藏 → 改用
.toggle() / .toggleClass();多函式輪流 → 改用計數器或狀態旗標。
- 若專案強依賴舊行為且無法重構,可引入 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