Ionic Gallery

Ionic Gallery

Ionic Image Gallery


Pedro Abreu

Pedro Abreu

Member since 2015


iOS, Android  
6 years ago
5 years ago
ionic, gallery, image, slideshow,


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

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

Add gallery directive with array of photos:

<ion-gallery ion-gallery-items="items"></ion-gallery>

Data source example

$scope.items = [ { src:'', sub: 'This is a <b>subtitle</b>' }, { src:'', sub: '' /* Not showed */ }, { src:'', thumb:'' } ]

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) { ionGalleryConfigProvider.setGalleryConfig({ action_label: 'Close', toggle: false, row_size: 3, fixed_row_size: true }); });

Default values action_label - 'Close' (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)

  • Via markup:

Markup overrides provider definitions

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

    <ion-gallery ion-gallery-items="items" ion-gallery-row="5"></ion-gallery>

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

    <ion-gallery ion-gallery-items="items" ion-gallery-toggle="false"></ion-gallery>

  • ion-item-callback: Overrides the default action with a custom callback when an item is tapped. Default: opens the slider modal

    <ion-gallery ion-gallery-items="items" ion-item-callback="callback(item)"></ion-gallery>