DIV CSS 佈局教程網

為 jQuery 擴充滑鼠滾輪事件:mousewheel 插件實作解析
編輯:JQuery特效代碼     

瀏覽器原生並沒有統一的「滑鼠滾輪」事件名稱:IE/Webkit 用 mousewheel,Gecko(Firefox)用 DOMMouseScroll,而且手寫 addEventListener 還得自己處理相容分支。把這些差異包成一個 jQuery 事件,之後就能像 click 一樣用 .mousewheel(fn),是相當典型的插件寫法練習。

一、註冊自訂事件

(function ($) {
    var types = ['DOMMouseScroll', 'mousewheel'];

    $.event.special.mousewheel = {
        setup: function () {
            if (this.addEventListener) {
                for (var i = types.length; i;) {
                    this.addEventListener(types[--i], handler, false);
                }
            } else {
                this.onmousewheel = handler;   // 舊 IE
            }
        },
        teardown: function () {
            if (this.removeEventListener) {
                for (var i = types.length; i;) {
                    this.removeEventListener(types[--i], handler, false);
                }
            } else {
                this.onmousewheel = null;
            }
        }
    };

$.event.special 是 jQuery 提供的事件掛勾點:setup 在第一個 handler 綁上時執行、teardown 在最後一個 handler 移除時執行。把原生綁定寫在這裡,好處是「綁一次就夠」與「全部解開才真正移除」都由 jQuery 代為管理,不會重複註冊。

二、對外開放的方法

    $.fn.extend({
        mousewheel: function (fn) {
            return fn ? this.bind("mousewheel", fn) : this.trigger("mousewheel");
        },
        unmousewheel: function (fn) {
            return this.unbind("mousewheel", fn);
        }
    });

傳入函式就綁定,不傳就觸發,這個「雙用途」設計在 jQuery 插件裡很常見,讓 API 更貼近直覺。

三、把各家 deltas 統一

    function handler(event) {
        var orgEvent = event || window.event,
            args = [].slice.call(arguments, 1),
            delta = 0, returnValue = true, deltaX = 0, deltaY = 0;

        event = $.event.fix(orgEvent);
        event.type = "mousewheel";

        // 舊式滾輪 delta
        if (event.originalEvent.wheelDelta) { delta = event.originalEvent.wheelDelta / 120; }
        if (event.originalEvent.detail)     { delta = -event.originalEvent.detail / 3; }

        deltaY = delta;

        // Gecko:判斷是否為水平滾動
        if (orgEvent.axis !== undefined && orgEvent.axis === orgEvent.HORIZONTAL_AXIS) {
            deltaY = 0;
            deltaX = -1 * delta;
        }

        // Webkit:多維度滾動(觸控板)
        if (orgEvent.wheelDeltaY !== undefined) { deltaY = orgEvent.wheelDeltaY / 120; }
        if (orgEvent.wheelDeltaX !== undefined) { deltaX = -1 * orgEvent.wheelDeltaX / 120; }

        args.unshift(event, delta, deltaX, deltaY);
        return $.event.handle.apply(this, args);
    }
})(jQuery);

這段是整個插件的精華:除以 120 是為了把各家不一的刻度單位歸一成「一格 = 1」,取負號是為了統一「往上滾為正」的方向慣例,最後再拆出 deltaX/deltaY 以支援觸控板的斜向滾動。

四、呼叫方式

$(document).mousewheel(function (e, delta, deltaX, deltaY) {
    // 依 delta 正負決定要放大還是縮小
});

有了它,做「滾輪縮放圖片」、「滾輪切換焦點圖」這類互動就只是判斷正負而已。要提醒的是,搶走滾輪預設行為會嚴重影響可用性,記得只在明確的互動區域內使用,並提供替代操作方式。

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