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');
效能與最佳實踐
- CSS Transition 配合:類切換觸發 CSS 動畫,比 JS animate 效能高。
- 避免頻繁重排:批量操作用
requestAnimationFrame 或統一類名修改。
- 事件委託:動態列表用
parent.on('event', 'selector', fn)。
- 語義化類名:
.is-active、.has-error、.is-loading 而非 .red、.big。