V-Zoom

A simple Javascript library for image zooming.

Demo

https://vdifoung.github.io/v-zoom/

Installation

Installing a V-Zoom module

V-Zoom is delivered primarily via npm. (https://www.npmjs.com/package/v-zoom)

# using npm install
$ npm i v-zoom

Non-module environments

If, for any reason, you are constrained to a non-module environment (e.g. no bundlers such as webpack) - don’t fret. Just embed:

<script src="dist/js/v-zoom.min.js"></script>

Usage

If you’re using a bundler, e.g. webpack, you’ll need to import v-zoom.

import "v-zoom";

To create v-zoom instance.

VZoom.init("tagName", {options});
# Or
VZoom.init("#myID", {options});
# Or
VZoom.init(".className", {options});

Configuration is optional and passed in an object {}.

Usage example

VZoom.init("img", {
    zoomEffect: "translate",
    duration: "500",
    backgroundColor: "rgba(0,0,0,.95)"
});

Options

| Config Option | Type | Default | Description | | --- |:---:|:---:| --- | | zoomEffect | String | translate | "translate" or "scale" Choose the zoom effect style. | | duration | Number\|String | 279 | Time to execute (ms) | | backgroundColor | String | rgba(0.0.0.1) | Background color. Example: "#000" or "rgba(0.0.0.1)" | | scrollToCancel | Boolean | true | Scrolling to cancel the image is being zoomed | | zoomPercentage | Number | 50 | 50%. Percentage of zoomed picture's size is compared with screen's size. To change zoom scale for each picture, use data-vzoom-scale="Number" attribute Example: <img src="img/thumbnail.png" data-vzoom-scale="1.95"> |

The v-zoom instance

// Retrieving the v-zoom instance
let vz = VZoom.init("img", {
    zoomEffect: "translate",
    duration: "500",
    backgroundColor: "rgba(0,0,0,.95)"
});

Methods

destroy()

vz.destroy();

Destroys the v-zoom instance, cleans up - removes event listeners, restores default, etc.

License

Licensed under MIT license, see LICENSE for the full license.