jQuery .toggle() (已於 1.9 移除) 易與 .toggleClass()、.slideToggle() 混淆。實際需求常為:多個按鈕互斥選中 (單選/Tab 效果),而非單一元素顯示/隱藏切換。本文釐清概念並提供標準實現模式。
.data('toggleState') 記錄狀態並手動重置。.removeData() 清除 toggle 內部計數器 (無效,toggle 無此機制)。toggle(fn1, fn2...) (事件綁定輪替) 與 toggleClass() (類別切換)。HTML 結構:
<ul class="sortBox">
<li><a href="javascript:;" data-type="subject">按學科統計</a></li>
<li><a href="javascript:;" data-type="classlevel">按年級統計</a></li>
<li><a href="javascript:;" data-type="lower">按下級統計</a></li>
</ul>
jQuery 實現:
$('.sortBox').on('click', 'a', function(e) {
e.preventDefault(); // 取消連結預設行為
var $this = $(this);
// 核心:當前加入 selected,兄弟移除 selected
$this.addClass('selected').siblings().removeClass('selected');
// 取得選中值,觸發業務邏輯
var type = $this.data('type');
console.log('切換至:', type);
// doFilter(type); // 實際篩選邏輯
});
// 頁面載入預設觸發第一個
$('.sortBox a').first().trigger('click');
.on('click', 'a', ...) 單一監聽器處理動態新增/移除的按鈕。selected 類別即為視覺與邏輯的唯一真實來源,無需額外變數追蹤。addClass('selected').siblings().removeClass('selected') 原子化完成「選中自己、取消其他」。data-type 將業務值附著於 DOM,JS 僅讀取 $this.data('type'),結構與行為解耦。.first().trigger('click') 確保初始狀態一致,避免重複邏輯。$.fn.radioGroup = function(options) {
var opts = $.extend({
itemSelector: 'a',
activeClass: 'selected',
onChange: $.noop
}, options);
return this.each(function() {
var $group = $(this);
$group.on('click', opts.itemSelector, function(e) {
e.preventDefault();
var $item = $(this);
if ($item.hasClass(opts.activeClass)) return; // 已選中不重複觸發
$item.addClass(opts.activeClass).siblings().removeClass(opts.activeClass);
opts.onChange.call(this, $item.data(), $item);
});
});
};
// 使用
$('.sortBox').radioGroup({
onChange: function(data, $el) {
console.log('類型切換:', data.type);
// 觸發篩選/請求
}
});
| 錯誤做法 | 問題 | 正確做法 |
|---|---|---|
用 .toggle() 綁定多個處理函式 | 1.9 移除,行為難預測 | 用 click + 狀態類別/旗標 |
| 用變數記錄每個按鈕計數 | 狀態分散、難同步 | DOM 類別為單一真實來源 |
用 removeData() 重置 toggle | toggle 無內部計數器 | 直接操作類別 |
| 點擊已選項仍觸發邏輯 | 重複請求/閃爍 | if ($item.hasClass('selected')) return; |
掌握「委派事件 + 狀態類別 + 資料屬性」三要素,即可輕鬆實現 Tab、單選、下拉選單等所有互斥切換 UI,代碼簡潔、效能優異、易於維護擴充。