gallery

Super lightweight lightbox gallery with no dependencies.

Usage no npm install needed!

<script type="module">
  import gallery from 'https://cdn.skypack.dev/gallery';
</script>

README

gallery

Super lightweight lightbox gallery with no dependencies.

Demo

View the example.html page live here:

https://gallery-gxfgq8lu8.now.sh/example.html

Usage

Will look for images with the attribute data-gallery-src and open a lightbox gallery on click.

Look in example.html for example usage.

Available tags

data-gallery-src

URL to large image to use in gallery

data-gallery-desc

(Optional) Description text/html to use below image in gallery

data-gallery-id

(Optional) Used to group multiple images in a gallery. If not specified will treat image to be part of global gallery.

Install

As npm package

npm install gallery
const gallery = require('gallery')

// Init galleries found inside document
gallery(document)

// Init galleries found inside specific node
gallery(document.querySelector('.some-node'))

As included script

<script src="gallery.min.js"></script>

Will automatically look for galleries on current page but also exposes a global method initGallery(parent).

Override styles

You can override the styles in gallery by plain css. The selectors used that can be overriden are:

.gallery-lightbox
.gallery-lightbox.-open
.gallery-lightbox > .close
.gallery-lightbox > .close
.gallery-lightbox > .close:after
.gallery-lightbox > .close:before
.gallery-lightbox > .description
.gallery-lightbox > .image
.gallery-lightbox > .image > img
.gallery-lightbox > .next
.gallery-lightbox > .next:after
.gallery-lightbox > .next:before
.gallery-lightbox > .prev
.gallery-lightbox > .prev:after
.gallery-lightbox > .prev:before