萬盛學電腦網

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

jQuery toggleClass 實戰:鼠標懸停動態切換 CSS 類完整案例

toggleClass 核心語法


// 基礎:切換單個類
$(selector).toggleClass('className');

// 多類切換 (空格分隔)
$(selector).toggleClass('class1 class2');

// 條件切換:true 添加,false 移除
$(selector).toggleClass('className', condition);

// 函數動態決定 (index, currentClass) => 返回類名字符串
$(selector).toggleClass(function(index, currentClass) {
    return 'dynamic-' + index;
});

// 開關狀態明確控制
$(selector).addClass('active');   // 強制添加
$(selector).removeClass('active'); // 強制移除
$(selector).hasClass('active');   // 檢查是否存在

完整實戰案例:導航菜單懸停高亮


<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>jQuery toggleClass 菜單懸停演示</title>
<style>
    ul, li { list-style: none; padding: 0; margin: 0; }
    li { 
        display: inline-block; 
        width: 100px; 
        text-align: center; 
        padding: 10px; 
        cursor: pointer; 
        transition: all 0.3s ease; /* 平滑過渡 */
    }
    .bg { 
        background: #e74c3c; 
        color: #fff; 
        transform: scale(1.05); 
        box-shadow: 0 4px 12px rgba(231, 76, 60, 0.3);
    }
</style>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<div id="nav">
    <ul>
        <li>菜單 1</li>
        <li>菜單 2</li>
        <li>菜單 3</li>
        <li>菜單 4</li>
        <li>菜單 5</li>
        <li>菜單 6</li>
    </ul>
</div>

<script>
$(function() {
    // 方式一:hover 事件雙回調 (進入/離開)
    $('#nav li').hover(
        function() { $(this).addClass('bg'); },   // mouseenter
        function() { $(this).removeClass('bg'); } // mouseleave
    );
    
    // 方式二:toggleClass 單回調 (自動切換)
    // $('#nav li').on('mouseenter mouseleave', function() {
    //     $(this).toggleClass('bg');
    // });
    
    // 方式三:委託事件 (動態添加的 li 也生效)
    // $('#nav').on('mouseenter mouseleave', 'li', function() {
    //     $(this).toggleClass('bg');
    // });
});
</script>
</body>
</html>

進階應用場景

1. 手風琴面板展開/收起


$('.panel-header').click(function() {
    var $panel = $(this).next('.panel-body');
    $panel.slideToggle(300);
    $(this).toggleClass('expanded'); // 箭頭旋轉等圖標變化
});

2. 表單驗證狀態切換


$('input').on('blur', function() {
    var valid = this.checkValidity();
    $(this).toggleClass('is-valid', valid).toggleClass('is-invalid', !valid);
});

3. 列表項選中狀態 (單選/多選)


// 單選:點擊項,切換自身 active,移除兄弟 active
$('.list-item').click(function() {
    $(this).addClass('active').siblings().removeClass('active');
});

// 多選:Ctrl/Cmd 點擊切換,單獨點擊清空其他
$('.list-item').click(function(e) {
    if (e.ctrlKey || e.metaKey) {
        $(this).toggleClass('active');
    } else {
        $(this).addClass('active').siblings().removeClass('active');
    }
});

4. 條件式切換:根據業務邏輯決定


// 庫存充足顯示綠色,不足顯示紅色
$('.product').each(function() {
    var stock = parseInt($(this).data('stock'));
    $(this).toggleClass('in-stock', stock > 0)
           .toggleClass('out-of-stock', stock === 0);
});

原生 JS 替代方案 (無 jQuery 依賴)


// 單元素
element.classList.toggle('className');

// 批量
document.querySelectorAll('.item').forEach(function(el) {
    el.classList.toggle('active');
});

// 條件切換
element.classList.toggle('active', condition); // 第二參數強制狀態

// 檢查
element.classList.contains('active');
element.classList.add('active');
element.classList.remove('active');

效能與最佳實踐

  1. CSS Transition 配合:類切換觸發 CSS 動畫,比 JS animate 效能高。
  2. 避免頻繁重排:批量操作用 requestAnimationFrame 或統一類名修改。
  3. 事件委託:動態列表用 parent.on('event', 'selector', fn)。
  4. 語義化類名:.is-active、.has-error、.is-loading 而非 .red、.big。
copyright © 萬盛學電腦網 all rights reserved