gallery

Super lightweight lightbox gallery with no dependencies

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
gallery
1.0.25 years ago10 years agoMinified + gzip package size for gallery in KB

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