vue inner image zoom

Complete project of a Vue component for magnifying an image within its original container. The zoom behavior is triggered on click and the image can be moved by dragging on touch devices and by either dragging or hover panning on non-touch devices. The component supports responsive images and optional full screen zoom on mobile

Table of Contents

Follow these steps to use vue inner image zoom

Installation

NPM

npm install vue-inner-image-zoom

Yarn

yarn add vue-inner-image-zoom

Styling

Import the CSS from your node_modules directory using:

import 'vue-inner-image-zoom/lib/vue-inner-image-zoom.css';

Usage

Import the component and include in your template:

import InnerImageZoom from 'vue-inner-image-zoom';

...

export default {
  components: {
    'inner-image-zoom': InnerImageZoom
  }
}

...

<inner-image-zoom src="/path/to/image.jpg" zoomSrc="/path/to/zoom-image.jpg" />

Props

Prop	Type	Default	Description
src	String		(Required) URL for the original image.
srcSet	String		Default srcset attribute for a responsive original image.
sizes	String		Default sizes attribute for use with srcset.
sources	Array		A list of image sources for using the picture tag to serve the appropriate original image (see below for more details).
width	Number		Width attribute for original image.
height	Number		Height attribute for original image.
hasSpacer	Boolean	false	If true, gets the original image’s aspect ratio based on the width and height props and creates a spacer to prevent cumulative layout shift.
zoomSrc	String		URL for the larger zoom image. Falls back to original image src if not defined.
zoomScale	Number	1	Multiplied against the natural width and height of the zoomed image. This will generally be a decimal (example, 0.9 for 90%).
zoomPreload	Boolean	false	If set to true, preloads the zoom image instead of waiting for mouseenter and (unless on a touch device) persists the image on mouseleave.
alt	String		Alternative text for the original image.
moveType	String	pan	`pan` or `drag`. The user behavior for moving zoomed images on non-touch devices.
zoomType	String	click	`click` or `hover`. The user behavior for triggering zoom. When using `hover`, combine with `zoomPreload` to avoid flickering on rapid mouse movements.
fadeDuration	Number	150	Fade transition time in milliseconds. If zooming in on transparent images, set this to `0` for best results.
fullscreenOnMobile	Boolean	false	Enables fullscreen zoomed image on touch devices below a specified breakpoint.
mobileBreakpoint	Number	640	The maximum breakpoint for fullscreen zoom image when fullscreenOnMobile is true.
hideCloseButton	Boolean	false	Hides the close button on touch devices. If set to true, zoom out is triggered by tap.
hideHint	Boolean	false	Hides the magnifying glass hint.
className	String		Custom classname for styling the component.
afterZoomIn	Function		Function to be called after zoom in.
afterZoomOut	Function		Function to be called after zoom out.

Props

Demo

Full Project