https://github.com/andreagiavatto/AGPhotoBrowser

A photo browser for iOS inspired by Facebook.
https://github.com/andreagiavatto/AGPhotoBrowser

Last synced: 3 months ago
JSON representation

A photo browser for iOS inspired by Facebook.

• Host: GitHub
• URL: https://github.com/andreagiavatto/AGPhotoBrowser
• Owner: andreagiavatto
• License: apache-2.0
• Created: 2013-09-02T22:40:55.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2017-07-26T21:51:10.000Z (over 7 years ago)
• Last Synced: 2024-10-31T15:32:39.077Z (3 months ago)
• Language: Objective-C
• Homepage:
• Size: 530 KB
• Stars: 447
• Watchers: 29
• Forks: 85
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome - AGPhotoBrowser - A photo browser for iOS inspired by Facebook. (etc)
• awesome - AGPhotoBrowser - A photo browser for iOS inspired by Facebook. (etc)

README

        
[![No Maintenance Intended](http://unmaintained.tech/badge.svg)](http://unmaintained.tech/)

AGPhotoBrowser

==============

A photo browser for iOS6 and iOS7 inspired by Facebook iOS app.

Demo project included.

It currently supports:

- Any number of images through a data source

- Optional title and description (with support for long description through a 'See more' button)

- Full screen view

- Pinch to zoom in/out

- Double tap to zoom in/out

- Orientation changes

- "Swipe up/down" to hide the photo browser

- "Done/Action buttons" to dismiss the browser or perform a few operations on the selected image

## Install

The suggested way to install the component is using [CocoaPods](http://cocoapods.org/), just include the following line in your Podfile to get the latest version:

`pod "AGPhotoBrowser"`

## Usage

There is a demo project included that shows how to use the photo browser.

- import `AGPhotoBrowserView.h` in your class

- create a new instance of `AGPhotoBrowserView` and set the delegate and the dataSource to your class

- implement `- (NSInteger)numberOfPhotosForPhotoBrowser:(AGPhotoBrowserView *)photoBrowser` and `- (UIImage *)photoBrowser:(AGPhotoBrowserView *)photoBrowser imageAtIndex:(NSInteger)index` methods from the datasource

- (optional) provide a title and a description for each image implementing `- (NSString *)photoBrowser:(AGPhotoBrowserView *)photoBrowser titleForImageAtIndex:(NSInteger)index` and `- (NSString *)photoBrowser:(AGPhotoBrowserView *)photoBrowser descriptionForImageAtIndex:(NSInteger)index`

- show the browser calling the `- (void)show` or `- (void)showFromIndex:(NSInteger)initialIndex` methods

- dismiss the photo browser with a completion block calling `- (void)hideWithCompletion:( void (^) (BOOL finished) )completionBlock`

## TO-DO

- ~~add pinch to zoom gesture on images~~ (from 1.0.4, thanks @dtsolis)

- ~~support orientation changes~~ (from 1.0.6)