@ks89/angular-modal-gallery

New package >=6:

Old package <=5:

Do you like @ks89/angular-modal-gallery? Please, add a 'star' to support this library

@ks89/angular-modal-gallery

@ks89/angular-modal-gallery is an Angular library (SSR compatible) to create image galleries.
Despite its name, this library is more than for modal galleries, because I'm introducing new features every major release. In fact, It's composed by 3 main parts

• plain-gallery: shows either a row, a column or a grid of clickable thumbnails using pure flexbox
• modal-gallery: is the core part of this project and display a modal window with full screen images, buttons, the current image and optionally, also navigation dots and previews
• carousel: is the new feature introduced in 7.0.0 to show a configurable plain carousel (not modal) with auto-play and other cool features

@ks89/angular-modal-gallery supports also keyboard shortcuts, swipe gestures and mouse events.

This library uses Semantic versioning 2.0.0 also known as 'semver'

:rocket: Main parts :rocket:

Carousel

Modal Gallery

Plain Gallery

:boom: Features :boom:

• Angular Module to import this library
• requires IE >= 11 and Angular >= 6
• works with both JIT and AOT compilers
• supports all recommended Angular Compiler Options
• compliant to Angular Package Format v6 specifications
• official examples with angular-cli, angular-cli + material, SystemJS and angular-universal HERE
• unit testing with high % coverage
• Server Side Rendering support with angular-universal
• Web Accessibility features, like ARIA support and toptal.com criteria (tested with Sim Daltonism for macOS)
• image download with buttons or keyboard shortcuts
• advanced keyboard shortcuts with mousetrap (both local and global)
• fully configurable default buttons to either close, download, navigate to an external url or delete images and so on
• support custom buttons with both pre and after hooks
• click outside feature to close the modal gallery clicking on the background
• configurable plain gallery
• configurable carousel
• configurable side-previews (visible only on bigger screen)
• configurable dots navigation (visible only on bigger screen)
• configurable previews (visible only on bigger screen)
• and so on... (check the official documentation HERE)

:package: Installation :package:

• npm install --save @ks89/angular-modal-gallery
• npm install --save hammerjs mousetrap
• npm install --save-dev @types/mousetrap @types/hammerjs

From version @ks89/angular-modal-gallery >= 5.0.0, font-awesome isn't a mandatory dependency. You can use all default features without font-awesome. For more info, check official documentation website.

:book: Documentation :book:

Image loading could be slow, because this website is hosted on Github pages

OFFICIAL DOCUMENTATION WEBSITE

:microphone: Live demo :microphone:

OFFICIAL LIVE DEMO

:warning: Which version should I use? :warning:

	@ks89/angular-modal-gallery	font-awesome
AngularJS	NOT SUPPORTED
Angular 2	<= 3.3.5	>= 4.0.0
Angular 4	<= 5.5.0	optional
Angular 5	>= 5.0.0	optional
Angular 6	>= 5.4.0	optional
Angular 7	>= 7.0.0	optional

:fire: News :fire:

More than 80 releases in two years, and more to come... :)

• 09/29/2018 - 7.0.0-alpha.1 - @ks89/angular-modal-gallery - HERE
• 09/15/2018 - 6.2.3 - angular-modal-gallery - HERE
• ... (many minor 6.x.x versions)
• 06/10/2018 - 6.0.0 - @ks89/angular-modal-gallery - HERE
• ... (many minor 5.x.x versions)
• 02/27/2018 - 5.0.0 - angular-modal-gallery - HERE
• ... (many minor 4.x.x versions)
• 11/05/2017 - 4.0.0 - angular-modal-gallery - HERE
• ... (many minor 3.x.x versions)
• 03/20/2017 - 3.0.0 - angular-modal-gallery - HERE
• ... (many minor 2.x.x versions)
• 01/29/2017 - 2.0.0 - angular-modal-gallery - HERE

:question: FAQS :question:

1. Question: I have this error: Cannot find name 'MousetrapInstance'. What can I do?
   Answer: Simply run npm i --save-dev @types/mousetrap
2. Question: I have this error: Error: No provider for KeyboardService. What can I do?
   Answer: You forgot to add .forRoot(), so KeyboardService will be never available as a service. Please read section "Installation" HERE. This is a common design pattern for Angular libraries. For more info check also this issue.
3. Question: How can I remove images using DELETE button without issues?
   Answer: You cannot change the input image array. Instead, you should reassign it with a newer array without the deleted element. In other words, you must think in a functional way, without changing the input array of images. For more information check this official demo HERE.

:computer: Contributing :computer:

Check CONTRIBUTING.md in this repository

Also, if you want to generate the internal library documentation, run npm run docs and open ./docs/typedoc/index.html.

:sparkling_heart: A big thank you to :sparkling_heart:

all authors of icons used in this library:

• Icons made by Smartline from www.flaticon.com is licensed by CC 3.0 BY
• Icons made by Dave Gandy from www.flaticon.com is licensed by CC 3.0 BY
• Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY
• Icons made by Those Icons from www.flaticon.com is licensed by CC 3.0 BY
• Icons made by Gregor Cresnar from www.flaticon.com is licensed by CC 3.0 BY
• Icons made by Smashicons from www.flaticon.com is licensed by CC 3.0 BY
• Icons made by Dario Ferrando from www.flaticon.com is licensed by CC 3.0 BY

all authors of spinners used in this library:

• Luke Haas (@lukehaas) - lukehaas/css-loaders
• Martin van Driel (@martinvd) - martinvd example on codepen.io
• Devilish Alchemist - devilishalchemist example on codepen.io
• Nikhil Krishnan - nikhil8krishnan example on codepen.io
• Anastasiya Kuligina - Anastasiya Kuligina example on codepen.io

:copyright: License :copyright:

The MIT License (MIT)

Copyright (c) 2017-2018 Stefano Cappa (Ks89)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

If you like my projects you can do a free donation here

FOSSA report

Created by Stefano Cappa

⬆ back to top

Changelog

7.0.0-alpha.2

Bugfixes

• fix responsive issue for carousel with fixed width
• fix wrong height of carousel's previews when hidden

Internal library changes

• upgrade to angular-cli 7 and Angular 7
• upgrade to Typescript 3.1.1
• add new MaxDirective to change max-height and max-width fully tested
• fix build internal docs with typedoc, using the latest @nect release to support typescript 3.1.1

Demos

• add new demo angular-cli-6 to test this library also on angular 6
• upgrade both angular-cli, universal and angular-cli-material to angular 7, angular-cli 7 and angular-material 7

Documentations

• improve documentation website with a new Font
• improve performance with service workers, external fonts and optimized images and SVGs
• fix SEO issues about H1-H6
• fix SEO issues about page titles and best practices about icons, themes, manifest.json and so on
• add Google Analytics
• update to Angular 7 and angular-cli 7
• improve SSR and prerender
• remove unused libs like ng-bootstrap, jquery, popper and others
• first implementation of app-shell (still no working because of some incompatibilities with third party libs)
• add some examples of Carousel
• remove sidebar for all pages except for demo and features
• add accordion to demo sidebar, also saved in local storage

Unit testing

• restore code coverage for library's unit testing
• restore multiple browsers to run tests
• add unit testing for id-validator service and improve it forcing integer id values > 0 (BREAKING CHANGE)