https://github.com/nicolafranchini/venobox

Responsive Vanilla JS lightbox plugin, suitable for images, videos, iFrames, inline contents
https://github.com/nicolafranchini/venobox

gallery gallery-images image-gallery javascript lightbox modal modal-windows popup responsive vanilla-javascript vanilla-js video vimeo youtube

Last synced: 8 months ago
JSON representation

Responsive Vanilla JS lightbox plugin, suitable for images, videos, iFrames, inline contents

• Host: GitHub
• URL: https://github.com/nicolafranchini/venobox
• Owner: nicolafranchini
• License: mit
• Created: 2013-11-05T16:22:21.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2024-05-03T07:09:01.000Z (about 2 years ago)
• Last Synced: 2025-10-22T19:49:15.568Z (8 months ago)
• Topics: gallery, gallery-images, image-gallery, javascript, lightbox, modal, modal-windows, popup, responsive, vanilla-javascript, vanilla-js, video, vimeo, youtube
• Language: JavaScript
• Homepage: https://veno.es/venobox/
• Size: 813 KB
• Stars: 706
• Watchers: 27
• Forks: 174
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# VenoBox

[![venobox (latest)](https://img.shields.io/npm/v/venobox/latest.svg)](https://www.npmjs.com/package/venobox)

[![venobox (downloads)](https://img.shields.io/npm/dy/vanilla-lazyload.svg)](https://www.npmjs.com/package/venobox)

[![](https://data.jsdelivr.com/v1/package/npm/venobox/badge)](https://www.jsdelivr.com/package/npm/venobox)

Responsive modal window javaScript plugin, touch swipe gallery

Just another responsive lightbox plugin, suitable for images, inline contents, iFrames, videos.

The big difference compared to many others plugins is that VenoBox calculates the max width of the image displayed and preserves its height if is taller than the window (so in small devices you can scroll down the content, avoiding vertical microscopic resized images).

Demo: https://veno.es/venobox/

## Quick start

### Install

This package can be installed with:

- [npm](https://www.npmjs.com/package/venobox): `npm install venobox`

- [composer](https://packagist.org/packages/nicolafranchini/venobox): `composer require nicolafranchini/venobox`

### Static HTML

Download the [latest release](https://github.com/nicolafranchini/VenoBox/releases)

or get the sources from [jsDelivr](https://cdn.jsdelivr.net/npm/venobox@latest/dist/)

Put the required stylesheet into your `` to load our CSS:

```html

```

Include the script near the end of your pages, right before the closing `` tag:

```html

```

### Usage

Insert one or more links with a custom class

```html



```

Initialize the plugin and your VenoBox is ready for all the selected links.

```javascript

new VenoBox({

  selector: '.venobox'

});

```

## Documentation

The full documentation is available at https://veno.es/venobox/

License: released under the MIT License