萬盛學電腦網

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

jQuery toggle() 多按鈕互斥切換問題:正確處理狀態重置與選中樣式

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');

關鍵點解析

  1. 事件委派:.on('click', 'a', ...) 單一監聽器處理動態新增/移除的按鈕。
  2. 狀態單一來源:selected 類別即為視覺與邏輯的唯一真實來源,無需額外變數追蹤。
  3. 互斥邏輯:addClass('selected').siblings().removeClass('selected') 原子化完成「選中自己、取消其他」。
  4. 資料屬性驅動:data-type 將業務值附著於 DOM,JS 僅讀取 $this.data('type'),結構與行為解耦。
  5. 預設觸發:.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() 重置 toggletoggle 無內部計數器直接操作類別
點擊已選項仍觸發邏輯重複請求/閃爍if ($item.hasClass('selected')) return;

掌握「委派事件 + 狀態類別 + 資料屬性」三要素,即可輕鬆實現 Tab、單選、下拉選單等所有互斥切換 UI,代碼簡潔、效能優異、易於維護擴充。

copyright © 萬盛學電腦網 all rights reserved