Skip to content
This repository has been archived by the owner on Aug 9, 2023. It is now read-only.

lstellway/ZoomIt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZoomIt - jQuery Zoom Plugin

jQuery plugin that adds simple, highly configurable dynamic zoom functionality for your images.

View Demo

Usage

  • Include jQuery
<script src="https://code.jquery.com/jquery-3.1.1.min.js"></script>
  • Include ZoomIt (CSS / Script)
<link rel="stylesheet" media="all" href="dist/styles/zoomit.css" />
<script src="dist/scripts/jquery.zoomit.min.js"></script>
  • Initialize on image element
<img id="zoomit-target" src="/path/to/small.jpg" data-zoomed="/path/to/large.jpg" alt="Image To Zoom">

<script type="text/javascript">
$('#zoomit-target').zoomIt();
</script>

Bower

The plugin is available on the Bower registry

bower install --save zoomit

NPM / Yarn

The package is also available via the NPM repository. Simply:

npm install --save zoomit

Or

yarn add zoomit

Options

  • img (jQuery Object) - The "unzoomed" image object that is intended to zoom
  • src (String | Function) - May either be a string or a function that returns a string of the path to the large image to be zoomed.
  • class (Object) - Object containing different class names used by the plugin
    • container (String: Default zoomit-container) - Class to be used for the container
    • loaded (String: Default loaded) - Class to be used when the zoomed image is loaded
    • img (String: Default zoomit-zoomed) - Class to be used for the zoomed image element
    • ghost (String: Default zoomit-ghost) - Class to be used for the "ghost" element above the zoomed image element. The "ghost" element is used to watch mouse events.

Events

  • onZoomIn (Function) - Callback function that is executed when the image is zoomed
    • The options object is passed as an argument
  • onZoomOut (Function) - Callback function that is executed when the image zoom is hidden
    • The options object is passed as an argument
  • onClick (Function) - Callback function that is executed when the zoom area is clicked
    • The options object is passed as an argument
  • onInit (Function) - Callback function that is executed when the plugin is initialized
    • The options object is passed as an argument

API

You can access the ZoomIt options by accessing the "zoom" data property of your specified img option - $(this) by default.

  • enable() - Enables zoom functionality
  • disable() - Disables zoom functionality

Example:

$('#zoomit-target').data('zoom').enable()

About

jQuery plugin that adds simple, highly configurable dynamic zoom functionality for your images.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages