1.3.1 • Published 4 years ago
wheelzoom-revived v1.3.1
layout: default
Wheelzoom Usage
Usage Demo
Based on this script, which is no longer manteined.
This is a pure Javascript library 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 doesn't add any extra elements to the DOM, or change the positioning of the IMG element.
Usage
Supported Browsers
Chrome, Safari, Opera, FireFox 17+, IE9+.
Instantiate wheelzoom
wheelzoom(document.querySelectorAll('img'));
// set zoom percent
wheelzoom(document.querySelectorAll('img'), {zoom:0.05});
// set max-zoom scale
var images = wheelzoom([
document.getElementById('img-1'),
document.getElementById('img-2'),
], {zoom:0.05, maxZoom:20});Subscribe for events
images[0].addEventListener('wheelzoom.reset', function(e) {
console.log('wheelzoom.reset fired');
});Fire events
triggerEvent(images[0], 'wheelzoom.destroy');Events available
| Event name | Description |
|---|---|
wheelzoom.reset | Fired when image zoom level return to zero. |
wheelzoom.destroy | Firing this event is possible to reset wheelzoom behaviour (see above example). |
wheelzoom.in | Fired when image is zoomed in (see full demo example). |
wheelzoom.out | Fired when image is zoomed out (see full demo example). |
wheelzoom.dragstart | Fired when start dragging on the image (see full demo example). |
wheelzoom.drag | Fired when image is dragged (see full demo example). |
wheelzoom.dragend | Fired when end dragging on the image (see full demo example). |
Configuration
| Name | Description | Default value |
|---|---|---|
zoom | The mouse wheel zoom ratio | 0.10 |
pinchSensibility | The pinch touch zoom ratio | 0.3 |
maxZoom | Max zoom value for an image | -1 |
API Documentation
| Function | Output | Description |
|---|---|---|
wheelzoom.images | Array | return all wheelzoom images |
wheelzoom.resetAll | undefined | Reset all wheelzoom images |
wheelzoom.destroyAll | undefined | Destroy all wheelzoom images |