OSS TanbouSign in with GitHub

jQuery Mouse Wheel Plugin

Normalize mouse-wheel deltas across browsers and input devices

About these scores

OSS scale score is an unbounded metric that log-compresses and weights Stars, Watchers, Forks, and Contributors. Discovery score is the current OSS scale score minus the score at discovery. Update pace is commits in the last 30 days, growth momentum is the OSS scale score difference within the recent observation window, and OSS health is a 0–100 rating based on available recency, Community Health, and release data.

Stars
3,914
Primary language
JavaScript
License
MIT
Repository last updated
Sep 28, 2026
On this page

Overview

jQuery Mouse Wheel Plugin 3.2.2 adds cross-browser mousewheel event support and delta normalization to jQuery. It extends the event object with deltaX, deltaY, and deltaFactor so applications can handle values from physical wheels and trackpads more consistently.

Features and best fit

Based on official documentation; not hands-on tested · Content checked:

Key features

Handle mousewheel events through jQuery on()

The README shows binding the mousewheel event to an element and reading normalized values from the event object.

Sources: [1]

Normalize deltaX and deltaY across browsers and devices

The plugin normalizes widely varying wheel and trackpad delta values into whole-number increments that are easier to handle consistently.

Sources: [1]

Recover browser-reported scroll distance with deltaFactor

The README explains that multiplying deltaFactor by deltaX or deltaY yields the scroll distance reported by the browser.

Sources: [1]

Best fit

Fits legacy jQuery interfaces that need consistent wheel-input handling

It is useful when existing jQuery event handling must absorb wheel input from different browsers and devices without rewriting the surrounding interaction model.

Sources: [1]

Before adoption

The mousewheel() and unmousewheel() helper methods are deprecated

The README marks the helper methods as deprecated and recommends .on("mousewheel", handler) instead.

Sources: [1]

Legacy delta/deltaX/deltaY handler arguments are also deprecated

The old three extra handler arguments are deprecated; new code should use properties on the event object.

Sources: [1]

Version 3.2.2 fixes npm packaging of the minified file

The 3.2.2 release adds the minified file to the npm package, matching the files list in package metadata.

Sources: [3][2]

Official sources

  1. [1]jQuery Mouse Wheel 3.2.2 README(2026-10-05)
  2. [2]jQuery Mouse Wheel 3.2.2 package metadata(2026-10-05)
  3. [3]jQuery Mouse Wheel 3.2.2 release(2026-10-05)
  4. [4]jQuery Mouse Wheel MIT license(2026-10-05)
Supplemental curator note

Prefer .on("mousewheel", ...). The mousewheel() / unmousewheel() helper methods and legacy handler arguments are deprecated, so new code should read deltaX, deltaY, and deltaFactor from the event object.

Try it in 3 steps

  1. 1

    Install pinned jQuery Mouse Wheel 3.2.2 with jQuery 4.0.0

    Create an isolated npm project with the reviewed wheel plugin and jQuery version pinned.

    demo=$(mktemp -d "${TMPDIR:-/tmp}/jquery-mousewheel.XXXXXX") && cd "$demo" && npm init -y >/dev/null && npm install --save-exact jquery-mousewheel@3.2.2 jquery@4.0.0
  2. 2

    Verify package versions

    Require jQuery Mouse Wheel and jQuery to resolve to the reviewed versions.

    test "$(node -e "const fs=require('fs');const m=JSON.parse(fs.readFileSync('node_modules/jquery-mousewheel/package.json'));const j=JSON.parse(fs.readFileSync('node_modules/jquery/package.json'));console.log(m.version+'/'+j.version)")" = '3.2.2/4.0.0'
  3. 3

    Check regular and minified distributions

    Verify both distribution files, including the minified file added to the npm package in 3.2.2.

    test -f node_modules/jquery-mousewheel/jquery.mousewheel.js && test -f node_modules/jquery-mousewheel/jquery.mousewheel.min.js
Check the official README

Growth

Growth trends · Last 30 days

3,914 Stars

Trend data is still being collected.

Development activity

Last 90 days · weekly

Commits (last 30 days)
0
Open PRs
13

Development activity is still being collected.

Built with

Categories and tags

Categories

GitHub data

GitHub dataView detailed GitHub data
Stars
3,914
Forks
1,629
Watchers
168
Open issues
4
Contributors
15
Owner type
Organization
Primary language
JavaScript
License
MIT
Repository last updated
Sep 28, 2026
Write a related article

Share a guide or use case for this OSS in Markdown. Articles are published after administrator approval.

Report incorrect information

Tell us if any listing information is incorrect or outdated.

After reading this page, do you know what to do next?