Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ironexdev/zoom
Lightweight (8 Kb) ES5 javascript plugin without any dependencies, compatible with desktop and mobile devices.
https://github.com/ironexdev/zoom
javascript lightweight plugin vanilla-javascript zoom
Last synced: 2 months ago
JSON representation
Lightweight (8 Kb) ES5 javascript plugin without any dependencies, compatible with desktop and mobile devices.
- Host: GitHub
- URL: https://github.com/ironexdev/zoom
- Owner: ironexdev
- License: apache-2.0
- Created: 2018-02-04T18:54:53.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-01-06T13:07:45.000Z (about 3 years ago)
- Last Synced: 2024-08-10T21:49:36.980Z (6 months ago)
- Topics: javascript, lightweight, plugin, vanilla-javascript, zoom
- Language: JavaScript
- Homepage: https://zoom.by-ironex.com
- Size: 917 KB
- Stars: 32
- Watchers: 3
- Forks: 13
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Zoom By Ironex
Lightweight (8 Kb) ES5 javascript plugin without any dependencies, compatible with desktop and mobile devices.
Supports doubleclick, mousemove, mousewheel, doubletap, touchmove and pinch events.
## Demo
https://zoom.by-ironex.com
## Installation
- Option 1
- ``` yarn add zoom-by-ironex ```
- include it in your scripts ``` import { zoom } from "zoom-by-ironex"; ```
- https://www.npmjs.com/package/zoom-by-ironex
- Option 2
- Add `` to the bottom of html ``
Whole script is just a single function called "zoom".
## How To Use
HTML
```
```
CSS (Optional)
```
.zoom-transition{ // Transition class name can be renamed in settings
transition: -moz-transform ease 200ms;
transition: -ms-transform ease 200ms;
transition: -o-transform ease 200ms;
transition: -webkit-transform ease 200ms;
transition: transform ease 200ms;
}
```
JS
```
zoom();
```
## Settings
Example call with all possible settings
```
zoom({
active: "zoom-active", // Class added to container when it is zoomed
transition: "zoom-transition", // Class added to images when they are being animated, class is removed after animation is finished
visible: "visible" // Class added to images after they are loaded,
zoom: "zoom" // Image container class
}, {
scaleDefault: 2, // Used on doubleclick, doubletap and resize
scaleDifference: 0.5, // Used on wheel zoom
scaleMax: 10, // Maximum zoom
scaleMin: 1, // Minimum zoom
scrollDisable: true, // Disable page scrolling when zooming an image
transitionDuration: 200, // This should correspond with zoom-transition transition duration
doubleclickDelay: 300 // // Delay between clicks - used when scripts decides if user performed doubleclick or not
}, (function ($container, zoomed) {
console.log(zoomed); // Callback, gets triggered whenever active class is added/removed from container, value of zoomed is true or false
}));
```
## Supported Events
- doubleclick
- mousemove
- mousewheel
- doubletap
- touchmove
- pinch
## Additional Info
Plugin checks if image container (zoom) exists on window.load and executes for each element with image container class. If there is no element with specified class present, then it stops.
- It means, that there is no need to check if image container (zoom) exists before executing the zoom function