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 });