----> compatible with Angular 17+ <----

Responsive image gallery designed for high resolution images.

The project consists of a gallery (+ viewer) and a script for image preparation.

https://oidamo.de/blog/gallery-demo

Before using the gallery, you have to process all of your images with the convert script.

The processed images will be stored to your applications assets.

The viewer takes care of an optimal image quality being served based on the users screen resolution.

Follow the instructions: http://www.graphicsmagick.org/README.html#installation

npm install angular2-image-gallery hammerjs --save

imports: [
  ...,
  Angular2ImageGalleryModule,
  HammerModule
],

node node_modules/angular2-image-gallery/convert.js <path/to/your/images>

Add a flag to define the order of the images inside the gallery

-n sort by file name (default)

-d sort chronologically by the original creation time

-c sort by primary image color

Additional optional parameter to support multiple galleries. Add it if you want to put your images into a separate gallery.

--gName=yourGalleryName

<gallery
    [flexBorderSize]="3"
    [flexImageSize]="7"
    [galleryName]="'yourGalleryName'"
    [maxRowsPerPage]="100"
    (viewerChange)="yourNotificationFunction($event)"
    [includeViewer]="true"
    [lazyLoadGalleryImages]="true"
></gallery>

All parameters are optional.

• [flexBorderSize] used to define the border thickness between the images within the gallery.
• [flexImageSize] used to define the size of the images with the gallery (not the viewer).
• [galleryName] used when having multiple galleries.
• [maxRowsPerPage] maximum rows per gallery, this will add navigation arrows once the threshold is reached.
• [viewerChange] event fires once the viewer component gets opened or closed.
• [includeViewer] provides an option to manually place the viewer outside the default DOM structure. Defaults to true.
• [lazyLoadGalleryImages] allows to disable lazy loading of gallery images. All images will be loaded at once when set to false. Defaults to true.

Fetching your images from an external data source: CLICK HERE

This is possible, but not the intent of this project. Please CLICK HERE

If the conversion process fails, make sure you have enough swap space provided.

If you experience any other issues, please raise an issue on GitHub.

• Angular 17 support

• Angular 16 support

• Adding optional parameter [lazyLoadGalleryImages] to turn off lazy loading when set to false and instead load all gallery images at once.

• Adding optional parameter [includeViewer] to support use cases where viewer is placed outside the gallery component manually

• Angular 15 support
• Performance improvements

• Refactor convert script entirely
• Provide smoother output for image conversion process

• Angular 14 support