@glry/core

@glry/core

Image gallery with mobile/touch support and no dependencies.

See the demo

Does not require you to specify all the images in the markup beforehand, instead you supply a load function which returns the next/prev image. This makes it ideal for large or dynamic galleries, where the images should be loaded based on changing logic.

The extension @glry/daily is an extension specifically designed for daily comic strips.

Install

$ npm install @glry/core

Usage

Place some basic HTML on your page:

<figure id="figure">
  <div class="loading">LOADING</div>
  <div class="error">ERROR</div>
  <nav class="navigation">
    <button class="prev">◀</button>
    <button class="next">▶</button>
  </nav>
</figure>

Initialize the gallery with a minimal set of options like this:

import Glry from '@glry/core';

const glry = new Glry({
  load: (direction) => (direction === 'left') ? 'prev-image.jpg' : 'next-image.jpg',
  canNavigate: (direction) => true,
});

The only required option is load which should be a function that returns the URL of the next/previous image. The function is passed a direction parameter indicating whether the navigation direction is "left" or "right".

You can optionally specify a canNavigate function, to prevent swiping in a given direction. This can be useful if you don't have an infinite amount of images and want to signal that the user has reached the end (or beginning).

Options

The available options and their defaults are as follows:

{
  target: '#figure',
  animationSpeed: 250,
  enableKeyboard: true,
  onLoadStart: false,
  onLoadEnd: false
}

You can pass a function to onLoadStart/onLoadEnd if you want to do some work before or after an image has loaded.

Keyboard navigation is enabled per default and maps to the ◀ / ▶ arrow keys for next/previous image.