插入式下拉選單、懸停顯示的名片、tooltip——這些元件都有同一個惱人問題:滑鼠從觸發元素移到彈出層的途中會經過一小段空隙,此時 mouseout 就觸發了,層被關掉。
var timer;
document.getElementById('test').onmouseover = function () {
clearTimeout(timer);
timer = setTimeout(function () { alert('over'); }, 150);
};
document.getElementById('test').onmouseout = function () {
clearTimeout(timer);
timer = setTimeout(function () { alert('out'); }, 150);
};
定時器的唯一 ID 由 timer 保存,mouseover 與 mouseout 都能清除尚未執行的定時器,避免重複觸發。
更關鍵的一步是:讓 timer 成為一個「組」。觸發元素與彈出層共用同一個 timer,滑鼠從觸發元素移到彈出層時,只要途中在層上停留,mouseout 的回呼就會被新的 mouseover 取消掉,層不會被誤關。
/*!
* hoverDelay.js
* Copyright 2011, TangBin
* Dual licensed under the MIT or GPL Version 2 licenses.
*/
(function (pluginName) {
var id = 0, data = {},
addEvent = function (elem, type, callback) {
if (elem.addEventListener) {
elem.addEventListener(type, callback, false);
} else {
elem.attachEvent('on' + type, function () { callback.call(elem); });
};
};
this[pluginName] = function (elem, over, out, group, speed) {
id++;
if (arguments.length === 0) return id;
if (typeof arguments[1] !== 'function') return clearTimeout(data[arguments[1]]);
if (typeof elem === 'string') elem = document.getElementById(elem);
group = group || elem[pluginName] || id;
speed = speed || 150;
elem[pluginName] = group;
addEvent(elem, 'mouseover', function () {
var elem = this,
fn = function () { over.call(elem); };
clearTimeout(data[group]);
data[group] = setTimeout(fn, speed);
});
addEvent(elem, 'mouseout', function () {
var elem = this,
fn = function () { out.call(elem); };
clearTimeout(data[group]);
data[group] = setTimeout(fn, speed);
});
};
})('hoverDelay');
data 負責保存自訂的「組」,同一組之下甚至可以暫停 mouseout 的回呼,从而实现嵌套操作。
| 方法 | 參數 | 作用 |
|---|---|---|
| hoverDelay(elem, over, out, group) | 元素、滑鼠靠近時回呼、滑鼠離開時回呼、延時分組名稱(可選) | 設定延時觸發效果 |
| hoverDelay(elem, group) | 元素、延時分組名稱 | 停止滑鼠離開執行的回呼 |
| hoverDelay() | 無 | 獲取唯一的延時分組名稱 |
注意到 jQuery API 對 hover 事件的說明:它會伴隨著對「滑鼠是否仍在特定元素內」的檢測(例如游標在 div 裡的圖片上移動),若是則繼續保持懸停狀態,不觸發移出事件——這修正了直接使用 mouseout 的一個常見錯誤。
這讓我聯想起工作中做過的「滑鼠觸發顯示名片」功能,經常被錯誤地執行 mouseout。查了 jQuery 的 hover 源碼,發現它用 mouseenter 與 mouseleave 取代了 mouseover 與 mouseout。前者是 IE(6、7、8)特有的,標準瀏覽器不支援,需要模擬。最終版本:
/*!
* hoverDelay.js v1.1
* Copyright 2011, TangBin
* Dual licensed under the MIT or GPL Version 2 licenses.
*/
(function (pluginName) {
var id = 0, data = {},
addEvent = function (elem, type, callback) {
if (elem.addEventListener) {
if (type === 'mouseenter') {
elem.addEventListener('mouseover', withinElement(callback), false);
} else if (type === 'mouseleave') {
elem.addEventListener('mouseout', withinElement(callback), false);
} else {
elem.addEventListener(type, callback, false);
};
} else {
elem.attachEvent('on' + type, function () {
callback.call(elem, window.event);
});
};
},
withinElement = function (callback) {
return function (event) {
var parent = event.relatedTarget;
try {
while (parent && parent !== this) parent = parent.parentNode;
if (parent !== this) callback.apply(this, arguments);
} catch (e) {};
};
};
this[pluginName] = function (elem, over, out, group, speed) {
id++;
if (arguments.length === 0) return id;
if (typeof arguments[1] !== 'function') return clearTimeout(data[arguments[1]]);
if (typeof elem === 'string') elem = document.getElementById(elem);
group = group || elem[pluginName] || id;
speed = speed || 150;
elem[pluginName] = group;
addEvent(elem, 'mouseenter', function () {
var elem = this, fn = function () { over.call(elem); };
clearTimeout(data[group]);
data[group] = setTimeout(fn, speed);
});
addEvent(elem, 'mouseleave', function () {
var elem = this, fn = function () { out.call(elem); };
clearTimeout(data[group]);
data[group] = setTimeout(fn, speed);
});
};
})('hoverDelay');
withinElement 是整個补丁的核心:mouseover 會在游標移動到子元素時不斷冒泡觸發,因此它沿著 relatedTarget(滑鼠來源元素)向上找父節點,只有在「來源元素不在目前元素內部」時,才認為滑鼠真的進來或離開了。這正是 mouseenter/mouseleave 的語意。
演示與下載:
https://demo.jb51.net/js/2011/hover/index.htm
原始碼:原生版 1.1、jQuery 插件版
今天的專案裡,這個問題有現成答案——標準的 mouseenter/mouseleave 已被所有現代瀏覽器支援,不必再手刻 relatedTarget 的判斷。但延時切換與「共用 timer 形成分組」這兩個設計,仍然值得借鑑:它們解決的是互動細節裡最容易被忽略、卻最影響觀感的那一類問題。