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 | Since: v1.3.0 (now functional)

Upper bound for the click-to-cycle and scroll-wheel zoom levels. Zoomora builds its progressive zoom steps (1.5×, 2×, 3×…) up to this value. Setting to 1 disables zoom entirely — the zoom button is hidden and scroll-wheel zoom is inactive. Invalid values (zero, negative, non-numeric) fall back to 3.

new Zoomora({ maxZoomScale: 5 }); // levels: 1× → 1.5× → 2× → 3× → 4× → 5×
new Zoomora({ maxZoomScale: 1 }); // zoom disabled entirely

zoomStep

Type: Number | Default: 0.1 | Since: v1.3.0 (now functional)

Scale increment applied per mouse-wheel tick during scroll-wheel zoom, expressed as a fraction of maxZoomScale. Smaller values give finer control; larger values jump faster. Has no effect when showZoom: false or maxZoomScale: 1.

new Zoomora({ zoomStep: 0.05 }); // fine control — smooth trackpad feel
new Zoomora({ zoomStep: 0.3 }); // coarse — fast jumps per scroll tick

Recommended Configurations

Photography Portfolio:

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

Product Images:

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

Video Gallery:

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