What's New

✨ Added

• openImage() API — open the lightbox programmatically with images not in the DOM. Accepts a URL string, array, or config object with src, thumb, type, caption, and alt. Closes #7

  lightbox.openImage('photo.jpg');
  lightbox.openImage(['a.jpg', 'b.jpg'], { startIndex: 1 });
  lightbox.openImage({ src: 'video.mp4', type: 'video', thumb: 'poster.jpg' });

• Scroll-wheel / trackpad-pinch zoom — continuous zoom via mouse wheel and trackpad pinch
• CSS custom properties — runtime theming without recompiling Sass:
  --zoomora-overlay-bg · --zoomora-control-bg · --zoomora-control-hover · --zoomora-primary

🐛 Fixed

• maxZoomScale option now actually controls the zoom ceiling (was hardcoded to 3×)
• zoomStep option now drives the scroll-wheel zoom increment (was documented but never wired up)
• LICENSE year corrected to 2026

🔧 Changed

• Vite ^7 → ^8, Sass ^1.89 → ^1.101
• Sourcemaps removed from minified dist outputs (*.min.js)

See CHANGELOG.md for the full list of changes.

CDN

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/zoomora@1.3.0/dist/zoomora.css">
<script src="https://cdn.jsdelivr.net/npm/zoomora@1.3.0/dist/zoomora.umd.min.js"></script>

npm

npm install zoomora@1.3.0

What's Fixed

• showZoom: false now correctly hides the zoom button
• showFullscreen: false now correctly hides the fullscreen and collapse buttons
• showCounter: false now correctly hides the counter
• showThumbnails: false now correctly hides the thumbnail strip and toggle button,
  and repositions the caption to the correct bottom offset
• Font glyph bounding box warning in Firefox is resolved

Upgrade

No breaking changes. Drop-in replacement for v1.2.0.

npm install zoomora@1.2.1

🎉 What's New in v1.2.0

✨ New Features

Background Click to Close (#4)

• Click anywhere outside the media to close the lightbox
• Thanks to [@dragoeco] for the suggestion!

⚙️ Configuration

new Zoomora({
  closeOnBackgroundClick: true // Enable/disable background click (default: true)
});

📦 Installation

npm install zoomora@1.2.0

Or via CDN:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/zoomora@1.2.0/dist/zoomora.css">
<script src="https://cdn.jsdelivr.net/npm/zoomora@1.2.0/dist/zoomora.umd.min.js"></script>

Full Changelog: v1.1.0...v1.2.0

🎉 Major Improvements in v1.1.0!

✨ New Features

• Progressive Zoom Levels: Click to zoom through multiple levels (1x → 1.5x → 2x → 3x → 100%)
• Smart Zoom Detection: Only enables zoom for images larger than viewport
• Enhanced Vertical Image Support: Proper handling of portrait-oriented images

🐛 Bug Fixes

• Fixed drag dezooming issue on all image orientations (#2)
• Fixed showAutoHideToggle option not working (#3)
• Fixed CSS transition conflicts during drag
• Fixed zoom button not responding on zoomed landscape images

🚀 Improvements

• Smoother drag experience on desktop and mobile
• Better boundary calculations for all image sizes
• Improved state management for reliable transforms
• Click vs drag detection to prevent accidental zooms

📦 Installation

NPM:

npm install zoomora@1.1.0

🎉 Initial Release

Zoomora is a modern, responsive lightbox plugin with zoom, fullscreen, and gallery features.

✨ Key Features

• Image galleries with smooth navigation
• Video support (YouTube & local files)
• Smart zoom with pan & drag
• Fully responsive
• Keyboard shortcuts
• Zero dependencies

📦 Installation

NPM:

npm install zoomora