ng-image-gallery

Angular directive for image gallery in modal with thumbnails or inline like carousel ###Preview

---

Dependencies

1. AngularJS
2. ngAnimate

Make sure you load all dependencies before loading ng-image-gallery files

---

Install

Download

→ using bower or npm

bower install --save ng-image-gallery
npm install --save ng-image-gallery

Include angular.min.js and angular-animate.min.js from bower components.

Include ng-image-gallery.min.js and ng-image-gallery.min.css from dist folder of this repository.

Include icons from res folder of this repository.

Include hammer.js for touch support (optional).

→ Manual

1. Install AngularJS or include <script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.5.7/angular.min.js"></script>
2. Install ngAnimate or include <script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.5.7/angular-animate.js"></script>
3. Include ng-image-gallery.min.js and ng-image-gallery.min.css from dist folder of this repository.
4. Include icons from res folder of this repository.
5. Include hammer.js from http://hammerjs.github.io (optional).

Configure

Add thatisuday.ng-image-gallery module to your app's dependencies.

var myTestApp = angular.module('test', ['thatisuday.ng-image-gallery']);

---

Create image gallery

<ng-image-gallery images="images" methods="methods" thumbnails="true | false | boolean-model" inline="true | false | boolean-model" on-open="opened();" on-close="closed();" img-bubbles="true | false | boolean-model" bg-close="true | false | boolean-model" bubbles="true | false | boolean-model"></ng-image-gallery>

You can also use <div ng-image-gallery ...></div> approach.

Options (attributes)

1. images

images is a JavaScript array that contains objects with image url(s) of the images to be loaded into the gallery. This object can be dynamic, means images can be pushed into this array at any time. This array looks like below...

// inside your app controller
$scope.images = [
	{
		thumbUrl : 'https://pixabay.com/static/uploads/photo/2016/06/13/07/32/cactus-1453793__340.jpg',
		url : 'https://pixabay.com/static/uploads/photo/2016/06/13/07/32/cactus-1453793_960_720.jpg',
		extUrl : 'http://mywebsitecpm/photo/1453793'
	},
	{
		url : 'https://pixabay.com/static/uploads/photo/2016/06/10/22/25/ortler-1449018_960_720.jpg'
	},
	{
		thumbUrl : 'https://pixabay.com/static/uploads/photo/2016/04/11/18/53/aviator-1322701__340.jpg',
		url : 'https://pixabay.com/static/uploads/photo/2016/04/11/18/53/aviator-1322701_960_720.jpg'
	}
];

thumbUrl is not absolutely necessary. If thumbUrl url is empty, thumbnail will use url instead to show preview.

extUrl is also optional, it is external link of current image. An `external link' icon with anchor link will be added beside close button.

--

2. methods (optional)

methods is a communication gateway between your app and image gallery methods. It's a JavaScript object which can be used to open or close the modal as well as change images inside gallery using prev and next key. This can be done as follows...

// inside your app controller
$scope.images = [...];

// gallery methods
$scope.methods = {};

// so you will bind openGallery method to a button on page
// to open this gallery like ng-click="openGallery();"
$scope.openGallery = function(){
	$scope.methods.open();
	
	// You can also open gallery model with visible image index
	// Image at that index will be shown when gallery modal opens
	//scope.methods.open(index); 
};

// Similar to above function
$scope.closeGallery = function(){
	$scope.methods.close();
};

$scope.nextImg = function(){
	$scope.methods.next();
};

$scope.prevImg = function(){
	$scope.methods.prev();
};

--

3. thumbnails (optional) [default : true]

thumbnails attribute is used when you need to generate thumbnails on the page of the gallery images. When user clicks on any thumbnail, gallery modal is opened with that image as visible image.

--

4. inline (optional) [default : false]

inline attribute is used when you need to inline image gallery instead in modal. When gallery is inline, no thumbnails will be generated and gallery will be launched automatically.

--

5. on-open (optional) [default : noop]

This is the callback function that must be executed after gallery modal is opened. Function in the controller will look like below

$scope.opened = function(){
	alert('Gallery opened'); // or do something else
}

--

6. on-close (optional) [default : noop]

Similar to on-open attribute but will be called when gallery modal closes.

--

7. img-bubbles (optional) [default : false]

To create image bubbles instead of simple circles. by default, bubble image url will be thumbUrl or url. But you can also add bubbleUrl (of small sizes images) to minimize request playload.

Not recommend if bubbles url defaults to url as it will download heavy images all at once.

--

8. bg-close (optional) [default : false]

close gallery on backgroud click. This can be very sensitivity in mobile devices. This will not work in inline gallery.

--

9. bubbles (optional) [default : true]

Turn on/off bubbles.

---

Touch support

• swipe right for prev
• swipe left for next
• doubletap to close gallery

Touch will be enabled only if hammer.js file is added.

---

Precautions

When gallery is inline

1. Do not open gallery manually, it will be automatically launched inline in the page.
2. Default dimensions of inline gallery is 100% by 300px. Make sure to customize it as per your needs on .ng-image-gallery-modal class inside .ng-image-gallery.inline class.
3. Do not use callbacks on inline gallery as it is useless to do so at least on open and close events.
4. By default, close button is hidden in inline gallery as it makes no sense.
5. Use bg-close carefully.

---

Traits

1. Provide support for thumbnail generation.
2. Dynamic population of images at any time.
3. Lazy-loading of images, meaning... loading animation will be showed in the gallery until image is downloaded.
4. jQuery independent.
5. Smooth animations.
6. Keypress support.
7. Responsive (using css flexbox) with touch support.
8. Image theft protection (simple way)
9. Total control on gallery from outside world.
10. Inline + Modal gallery, awesome combo.

---

Build on your own

You can build this directive with your own customization using gulp.

1. Go to repository's parent directory and install all node dev dependencies using npm install --dev.
2. Make sure you have gulp install globally. Else use npm install -g gulp to install gulp globally.
3. All css for this repository has been generated using sass (.scss), so you need to spend 5 mins to learn basics of sass.
4. To build or watch the changes, use command gulp build or gulp watch

---

Contributions and Bug reports

1. Please create an issue if you need some help or report a bug.
2. Take a pull request to add more features or fix the bugs. Please mention your changes in the PR.
3. Please make sure you recommend good practices if you came/come accross any or if something could have been better in this module.