Skip to content

Behaviour Options

transition

Type: String | Default: 'fade' | Values: 'fade' or 'slide'

new Zoomora({ transition: 'slide' });

'fade' scales the image up from 80% while fading in. 'slide' slides it in from the right — works best for galleries where left/right navigation matches the slide direction.


animationDuration

Type: Number | Default: 300

Duration in milliseconds. Set to 0 to disable transitions. 300–400ms is recommended — above 600ms feels sluggish during fast navigation.

new Zoomora({ animationDuration: 400 });

closeOnBackgroundClick

Type: Boolean | Default: true | Since: v1.2.0

Clicking the dark overlay outside the image closes the lightbox. Set to false for video galleries to prevent accidental dismissal.

new Zoomora({ closeOnBackgroundClick: false });

maxZoomScale

Type: Number | Default: 3

Upper bound for zoom levels. Setting below 1.5 effectively disables zoom for most images.

new Zoomora({ maxZoomScale: 4 });

Recommended Configurations

Photography Portfolio:

new Zoomora({ transition: 'fade', animationDuration: 400, autoHideEnabled: true, autoHideDelay: 2000 });

Product Images:

new Zoomora({ transition: 'slide', animationDuration: 250, maxZoomScale: 4 });

Video Gallery:

new Zoomora({ transition: 'fade', closeOnBackgroundClick: false, showZoom: false });

On This Page