Zoomifyjs is a lightweight (only 1kb gzipped) image zoom plugin with no dependencies and no styling. As Brad Frost once said "do that shit yourself". It is 100% open source and available on Github. It is free to use on personal and commercial projects. Use it with your favourite module bundler or by manually injecting the script into your project.

Full docs: https://mrazinshaikh.github.io/zoomifyjs

1. Installation
2. Options
3. API
4. Contributing
5. Roadmap
6. Extra

Installation

Setup is easy. A little bit of markup...

<picture>
    <img 
        src="./assets/car-image-300x300.webp"
        zoomify="./assets/car-image.webp"
        alt="Car-Image"
        id="zoomifyJs"
    >
</picture>

If you are using a module bundler like Webpack or Vite...

npm install zoomifyjs

Or from yarn

yarn add zoomifyjs # Available soon....

import ZoomifyJs from "zoomifyjs";
new ZoomifyJs();

...or manually inject the minified script into your website.

<script src="zoomifyjs.umd.js"></script>
<script>
  new ZoomifyJs();
</script>

Options

ZoomifyJs comes with a few (optional) settings that you can change by passing an object as an argument. Default values are presented below.

new ZoomifyJs({
  selector: '.zoomifyJs',
  transitionDuration: 300,
  easing: 'ease-in-out',
  scale: 2,
  clickToZoom: true
});

selector (string)
The selector to use as a carousel. Make sure to set proper sizing on image element (which will be used on parent element as max sizing to prevent image overflowing on scale)

transitionDuration (number)
Zoom transition duration in milliseconds.

easing (string)
It is like a CSS transition-timing-function — describes acceleration curve.

scale (number)
The number of zoom scale amount.

clickToZoom (boolean)
Enable zoom after click on the image.

Api

destroy (function)
Remove zoom instance from the element

Contributing

Coming soon...

Roadmap

1. [x] ~~Register on npm package registry~~
2. [ ] Register on yarn package registry
3. [x] ~~Register for cdn.~~ (npmjs provide cdn via unpkg.)
4. [ ] Enable zoom on multiple image with single instance
5. [x] ~~Allow DOMElement for selector value~~
6. [ ] Image parent element styling improvement (needs basic styling on instance initialization, before clickToZoom)
7. [ ] Change image source bug fix
8. [ ] Allow customizing click to zoom button stylings
9. [ ] Codepen collection for more examples
10. [ ] migrate to ts for better type-hinting and type safety.

Extra

• Code structure and initial docs on github-pages using jekyll is inspired from siema a carousel plugin.

License

Made with ❤️

Published under MIT License.