jQuery 封裝了原生事件,創建了合成事件,提供更便捷的 API。最典型的是 hover() 和 toggle()(點擊切換版,已移除)。
$(selector).hover(handlerIn, handlerOut)
// 等價於
$(selector).on('mouseenter', handlerIn).on('mouseleave', handlerOut);
handlerIn:鼠標進入元素時觸發(對應 mouseenter)handlerOut:鼠標離開元素時觸發(對應 mouseleave)$(function() {
$('#menu > li').hover(
function() { $(this).children('ul').stop(true, true).slideDown(200); },
function() { $(this).children('ul').stop(true, true).slideUp(200); }
);
});
| 特性 | hover() / mouseenter/leave | mouseover/out |
|---|---|---|
| 冒泡 | **不冒泡** | 冒泡 |
| 子元素觸發 | 不觸發(進入子元素不算離開父元素) | 頻繁觸發(進入子元素觸發父元素 mouseout) |
| 適用場景 | 下拉選單、工具提示、卡片懸停 | 需追蹤鼠標在元素內移動軌跡 |
// 正確觸發 hover 的離開處理
$('#element').trigger('mouseleave'); // ✅
$('#element').trigger('mouseout'); // ❌ 不會觸發 hover 的 handlerOut
重要:toggle(fn1, fn2...) 作為點擊輪流執行不同函數的功能在 **jQuery 1.9+ 已移除**(與動畫 toggle() 衝突)。
let isOpen = false;
$('#trigger').on('click', function() {
isOpen = !isOpen;
if (isOpen) {
$('#panel').slideDown();
$(this).addClass('active');
} else {
$('#panel').slideUp();
$(this).removeClass('active');
}
});
function createToggle(...fns) {
let index = 0;
return function(...args) {
fns[index](...args);
index = (index + 1) % fns.length;
};
}
const toggleHandler = createToggle(
() => console.log('狀態 1'),
() => console.log('狀態 2'),
() => console.log('狀態 3')
);
$('#btn').on('click', toggleHandler);
$('#btn').on('click', function() {
const $this = $(this);
const state = $this.data('toggleState') || 0;
const states = [
() => { $this.text('狀態 A'); },
() => { $this.text('狀態 B'); },
() => { $this.text('狀態 C'); }
];
states[state]();
$this.data('toggleState', (state + 1) % states.length);
});
動畫方法 .toggle([duration], [easing], [complete]) **保留**,用於切換元素可見性:
// 簡單切換
$('#panel').toggle();
// 帶動畫
$('#panel').toggle(300); // 300ms 滑動切換
// 回調
$('#panel').toggle(300, function() {
console.log('動畫完成,可見性:', $(this).is(':visible'));
});
$(function() {
$('#panel h5.head').on('click', function() {
const $this = $(this);
const $content = $this.next();
const isVisible = $content.is(':visible');
$content.slideToggle(300);
$this.toggleClass('highlight', !isVisible);
});
});
// CSS
// .highlight { background: #ffeb3b; font-weight: bold; }
:hoverhover() = mouseenter + mouseleave(不冒泡),適合下拉/懸停交互toggle(fn1, fn2...) **已移除**,請用標誌變量或數組輪詢替代toggle() (動畫) 保留,用於顯示/隱藏切換