DIV CSS 佈局教程網

滑鼠事件延時切換插件 hoverDelay 實作解析
編輯:關於JavaScript     

插入式下拉選單、懸停顯示的名片、tooltip——這些元件都有同一個惱人問題:滑鼠從觸發元素移到彈出層的途中會經過一小段空隙,此時 mouseout 就觸發了,層被關掉。

原理:用 setTimeout 做延遲,用 clearTimeout 取消

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()無獲取唯一的延時分組名稱

2011-01-22 更新:mouseover/mouseout 真的有 bug

注意到 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 形成分組」這兩個設計,仍然值得借鑑:它們解決的是互動細節裡最容易被忽略、卻最影響觀感的那一類問題。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved