嘗試用 $(element).trigger("hover") 程式化觸發 hover 效果,但完全無反應。同樣代碼換成 click 則正常運作。
jQuery 中不存在 "hover" 事件類型。
hover(handlerIn, handlerOut) 是 語法糖,內部綁定的是兩個獨立事件:
mouseenter (對應 handlerIn)mouseleave (對應 handlerOut)因此 trigger("hover") 找不到任何綁定 "hover" 類型的處理器。
// 觸發進入效果
$element.trigger("mouseenter");
// 觸發離開效果
$element.trigger("mouseleave");
// 或鏈式觸發完整流程
$element.trigger("mouseenter").trigger("mouseleave");
var handlerIn = function() { /* ... */ };
var handlerOut = function() { /* ... */ };
$element.hover(handlerIn, handlerOut);
// 程式化調用
handlerIn.call(element); // 需正確綁定 this
handlerOut.call(element);
$element.on("custom-hover-enter", function() { /* 進入邏輯 */ });
$element.on("custom-hover-leave", function() { /* 離開邏輯 */ });
// 綁定原生事件到自定義事件
$element.on("mouseenter", function() { $(this).trigger("custom-hover-enter"); });
$element.on("mouseleave", function() { $(this).trigger("custom-hover-leave"); });
// 程式化觸發
$element.trigger("custom-hover-enter");
舊版 live()、delegate() 同樣不支援 "hover" 事件類型:
// ❌ 無效
$(document).on("hover", ".item", handlerIn, handlerOut);
// ✅ 正確:分別綁定
$(document).on("mouseenter", ".item", handlerIn);
$(document).on("mouseleave", ".item", handlerOut);
// ✅ 或使用 hover 方法 (內部自動轉換)
$(document).on("mouseenter mouseleave", ".item", function(e) {
if (e.type === "mouseenter") handlerIn.call(this);
else handlerOut.call(this);
});
// jQuery 核心相關片段 (簡化)
jQuery.fn.hover = function(fnOver, fnOut) {
return this.on("mouseenter", fnOver).on("mouseleave", fnOut || fnOver);
};
// 事件綁定最終都走 on()
jQuery.fn.on = function(types, selector, data, fn) {
// types 可以是 "click"、"mouseenter mouseleave" 等空格分隔字串
// 但 "hover" 不在標準事件列表中,不會被特殊處理
// ...
};
// trigger() 只是查找並執行指定 type 的 handlers
jQuery.fn.trigger = function(type, data) {
return this.each(function() {
jQuery.event.trigger(type, data, this);
});
};
| 場景 | 推薦做法 |
|---|---|
| 單元測試模擬使用者互動 | 使用 fireEvent (Testing Library) 或原生 dispatchEvent |
| 元件內部狀態切換 | 直接呼叫內部方法,而非透過事件模擬 |
| 第三方插件觸發 | 檢查插件文檔支援的事件類型,通常是 mouseenter/mouseleave |
| 自動化測試 | Cypress: cy.realHover()、Puppeteer: page.hover() |
// 觸發 mouseenter
element.dispatchEvent(new MouseEvent("mouseenter", { bubbles: true }));
// 觸發 mouseleave
element.dispatchEvent(new MouseEvent("mouseleave", { bubbles: true }));
// 完整 hover 流程 (進入 → 停留 → 離開)
async function simulateHover(element, duration = 100) {
element.dispatchEvent(new MouseEvent("mouseenter", { bubbles: true }));
await new Promise(r => setTimeout(r, duration));
element.dispatchEvent(new MouseEvent("mouseleave", { bubbles: true }));
}
trigger("hover") 失效的根因是 "hover" 不是真實事件類型,而是 jQuery 的便利方法。解決方法是直接觸發底層的 mouseenter 和 mouseleave 事件。這提醒我們:理解庫的抽象層實現細節,能避免大量除錯時間。現代開發中,優先使用原生 dispatchEvent 或測試庫工具,減少對 jQuery 事件系統特殊行為的依賴。