Skip to content
A small script for zooming IMG elements with the mousewheel/trackpad.
Branch: master
Clone or download


A small script for zooming IMG elements with the mousewheel/trackpad. Wheelzoom works by replacing the img element's src with a transparent image, then using the original src as a background image, which can be sized and positioned. Wheelzoom is dependency free, doesn't add any extra elements to the DOM, or change the positioning of the IMG element.


// or
wheelzoom(document.querySelectorAll('img'), {zoom:0.05});
// zoom sets the zoom percent.


MIT License

Supported Browsers:

Chrome, Safari, Opera, FireFox 17+, IE9+.


v.4.0.0 - 2018/10/09
  • Replaced canvas data URI with base64 svg for creating placeholder
  • Dropped IE9 support
v.3.1.3 - 2018/01/31
  • Added 'initialZoom' option. Resolves #32
v.3.1.2 - 2017/04/20
  • Added package.json & added to NPM.
v.3.1.0 - 2017/04/10
  • Added 'maxZoom' option for maximum zoom level.
v.3.0.4 - 2015/12/15
  • Automatically account for changes to the img src, to avoid requiring manually calling destroy and reapply.
v.3.0.3 - 2015/09/05
  • Fixed zoom positioning issue in Firefox. Fixes #17
  • Fixed error when calling destroy in Firefox. Fixes #16
  • Removed debugging statement. Fixes #15
v.3.0.2 - 2015/09/05
  • Fixed lint warnings and bug introduced in 3.0.1
v.3.0.1 - 2015/09/05
  • Fixed issue with src URLs that contain single quotes. Fixes #13.
v.3.0.0 - 2014/10/14
  • Removed jQuery dependency
  • Added 'wheelzoom.destroy' event for removing changes that wheelzoom has made to an element.
v.2.0.1 - 2014/9/9
  • Merged bugfix to wrap background-image path in quotes. Ref #8.
v.2.0.0 - 2014/4/17
  • Simplified by dropping support for having border and padding on the img element. Borders and/or padding should be applied to the parent element, rather than the img element.
v.1.1.3 - 2014/4/13
  • Minor code improvement.
v.1.1.2 - 2013/1/31
  • Fixed bug with unzoom trigger.
v1.1.1 - 2013/1/29
  • Added trigger to unzoom image:
v1.1.0 - 2012/11/28
  • Added dragging.
v1.0 - 2012/11/26
  • Initial release.
You can’t perform that action at this time.