DIV CSS 佈局教程網

jQuery hover 延時器實作:用 mouseDelay 避免誤觸
編輯:JQuery特效代碼     

jQuery 1.4 之後提供了 delay() 方法,可以很容易地在動畫序列之間插入等待時間:

$('#foo').slideUp(300).delay(800).fadeIn(400);  // 兩段動畫之間停 800 毫秒

那麼,hover 能不能也加上延時器?答案是肯定的。

為什麼 hover 需要延時

延時的核心目的是過濾使用者的誤觸。一般來說,滑鼠指標停留時間低於 150 毫秒的,多半只是路過,可以忽略。若强行改寫 delay 讓它作用在 hover 上,技術上可行,但為了避免 jQuery 本體持續演進造成相容性問題,還不如老實寫成標準外掛來得穩妥。

設計目標

  • 保有 jQuery API 的優雅度:jQuery(expression).mouseDelay(150).hover(over, out)
  • 不破壞 jQuery 原型鏈,維持可鏈式呼叫

原始碼

/*!
 * jQuery.mouseDelay.js v1.2
 * https://www.planeart.cn/?p=1073
 * Copyright 2011, TangBin
 * Dual licensed under the MIT or GPL Version 2 licenses.
 */
(function ($, plugin) {
  var data = {}, id = 1, etid = plugin + 'ETID';

  // 延時構造器
  $.fn[plugin] = function (speed, group) {
    id++;
    group = group || this.data(etid) || id;
    speed = speed || 150;

    // 快取分組名稱到元素
    if (group === id) this.data(etid, group);

    // 暫存官方的 hover 方法
    this._hover = this.hover;

    // 偽裝一個 hover 函式,攔截兩個回呼交給真正的 hover 處理
    this.hover = function (over, out) {
      over = over || $.noop;
      out  = out  || $.noop;
      this._hover(
        function (event) {
          var elem = this;
          clearTimeout(data[group]);
          data[group] = setTimeout(function () {
            over.call(elem, event);
          }, speed);
        },
        function (event) {
          var elem = this;
          clearTimeout(data[group]);
          data[group] = setTimeout(function () {
            out.call(elem, event);
          }, speed);
        }
      );
      return this;
    };
    return this;
  };

  // 凍結選定元素的延時器
  $.fn[plugin + 'Pause'] = function () {
    clearTimeout(this.data(etid));
    return this;
  };

  // 靜態方法
  $[plugin] = {
    get: function () { return id++; },               // 取得唯一分組名稱
    pause: function (group) { clearTimeout(data[group]); }  // 凍結指定分組
  };
})(jQuery, 'mouseDelay');

API 說明

  • mouseDelay(speed, group):兩個參數皆為選填。speed 為延時毫秒數,group 為延時分組名稱。呼叫後即啟用延時效果。
  • mouseDelayPause():無參數,凍結選定元素目前的延時器。
  • jQuery.mouseDelay.pause(group):依分組名稱凍結該組的延時器。
  • jQuery.mouseDelay.get():取得一個不重複的分組名稱。

檔案與範例

提供 jQuery.mouseDelay.js 與壓縮版 jQuery.mouseDelay.min.js 兩個檔案。

線上展示:https://demo.jb51.net/js/2011/mouseDelay/index.htm

本文為 planeArt.cn 原創文章。

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