Getting Started

LightGallery is a lightweight modular responsive jquery lightbox gallery wich lets you to create beautiful image & video galleries.

Main features

  • Fully responsive.
  • Modular architecture with inbuilt plugins.
  • Touch and support for mobile devices.
  • Mouse drag supports for desktops.
  • Animated thumbnails.
  • Youtube Vimeo and html5 videos Support.
  • 20+ Hardware-Accelerated CSS3 transitions.
  • Dynamic mode.
  • Full screen support.
  • Supports zoom.
  • Responsive images.
  • HTML iframe support.
  • Multiple instances on one page.
  • Easily customizable via CSS (SCSS) and Settings.
  • Smart image preloading and code optimization.
  • Keyboard Navigation for desktop.
  • Font icon support.

Installation

Install with Bower

You can Install lightgallery using the Bower package manager.

$ bower install lightgallery

Install with npm

You can also find lightgallery on npm.

$ npm install lightgallery

Download from Github

You can also directly download lightgallery from github.

include CSS and Javascript files

First of all add lightgallery.css in the <head> of the document

<head>
    <link type="text/css" rel="stylesheet" href="css/lightGallery.css" /> 
</head>  

Then include jQuery and lightgallery.min.js into your document.
If you want to include any lightgallery plugin you can include it after lightgallery.min.js.

<body>
    ....

    <!-- jQuery version must be >= 1.8.0; -->
    <script src="jquery.min.js"></script>
    <script src="js/lightgallery.min.js"></script>

    <!-- lightgallery plugins -->
    <script src="js/lg-thumbnail.min.js"></script>
    <script src="js/lg-fullscreen.min.js"></script>
</body>  

The markup

lightgallery does not force you to use any kind of markup. you can use whatever markup you want. But i suggest you to use the following markup. Here you can find the detailed examples of deferent kind of markups.

<div id="lightgallery">
  <a href="img/img1.jpg">
      <img src="img/thumb1.jpg" />
  </a>
  <a href="img/img2.jpg">
      <img src="img/thumb2.jpg" />
  </a>
  ...
</div>

Call the plugin

Finally you need to initiate the gallery by adding the following code.

<script type="text/javascript">
    $(document).ready(function() {
        $("#lightgallery").lightGallery(); 
    });
</script>