by pedroabreu

pedroabreu / ion-gallery

Ionic gallery directive

128 Stars 66 Forks Last release: almost 4 years ago (0.2) MIT License 99 Commits 11 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Ionic gallery with slider

Demo availabe in Ionic View with id 150745FE

$ bower install --save ion-gallery


  • Define number of collums to present (1 to array length)
  • Pinch and double tap do zoom on picture


Load script and css on the html


Add ion-gallery as dependency to your project

 .module('starter', ['ionic','ion-gallery'])

Add gallery directive with array of photos:

Data source example

$scope.items = [
    sub: 'This is a subtitle'
    sub: '' /* Not showed */

Thumbnail property is also optional. If no thumbnail, the source content will be used

Subtitle property is optional. If no property present, nothing is showed (Same for empty string). Supports html tags.

UI will reflect changes on the content object passed to the directive. Example of adding and removing pictures can be seen in the ionic view app.


  • Via provider:

Default values in example.

app.config(function(ionGalleryConfigProvider) {
                          action_label: 'Close',
                          template_gallery: 'gallery.html',
                          template_slider: 'slider.html',
                          toggle: false,
                          row_size: 3,
                          fixed_row_size: true
Default values
action_label - 'Close' (String)
template_gallery - 'gallery.html' (String)
template_slider - 'slider.html' (String)
toggle - false (Boolean)
row_size - 3 (Int)
fixed_row_size - true (boolean). If true, thumbnails in gallery will always be sized as if there are "row_size" number of images in a row (even if there aren't). If set to false, the row_size will be dynamic until it reaches the set row_size (Ex: if only 1 image it will be rendered in the entire row, if 2 images, both will be rendered in the entire row)
zoom_events - true (Boolean)
  • Via markup:

Markup overrides provider definitions

  • ion-gallery-row: Defines size of the row. Default to 3 images per row

  • ion-gallery-toggle: Sets one tap action on slideshow to hide/show subtitles and "Done" button. Default: true

  • ion-item-action: Overrides the default action when a gallery item is tapped. Default: opens the slider modal

  • ion-zoom-events: Enable/Disable all zoom events in slider (pinchToZoom, tap and double tap). Default: true


We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.