Skip to content

heikkihautala/NYTPhotoViewer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NYTPhotoViewer

NYTPhotoViewer is a slideshow and image viewer that includes double tap to zoom, captions, support for multiple images, interactive flick to dismiss, animated zooming presentation, and more.

Demo

Demo GIF

Implementation

NYTPhotoViewer has a very standard implementation using built-in frameworks. The viewer is a UIViewController and uses UIViewController transitioning APIs for the animated and interactive transitions, a UIPageViewController for horizontal swiping between images, and UIScrollView for image zooming. It is intended to be used without the need for subclassing, and as such it accepts model objects conforming to a NYTPhoto protocol and provides ample opportunity for customization via the NYTPhotosViewControllerDelegate. Since standard APIs are used, the client has full control over the transitions and customization of the NYTPhotosViewController.

Usage

Usage is simple, with the option for more complicated customization when needed through a delegate relationship. In the most basic implementation, just initialize the view controller with an array of photo objects and present it as normal:

NYTPhotosViewController *photosViewController = [[NYTPhotosViewController alloc] initWithPhotos:photos];
[self presentViewController:photosViewController animated:YES completion:nil];

Installation

NYTPhotoViewer is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "NYTPhotoViewer"

Requirements

This library requires a deployment target of iOS 7.0 or greater.

Inspiration

NYTPhotoViewer draws feature inspiration from Facebook and Tweetbot's image viewers. If this implementation isn't to your liking, you may want to consider JTSImageViewController or IDMPhotoBrowser.

Swift

NYTPhotoViewer is written in Objective-C but is intended to be fully interoperable with Swift. If you experience any interoperability difficulties, please open an issue or pull request and we will work to resolve it quickly.

TODO

  • Animate bounds changes like Tweetbot and Facebook.
  • Publicly expose the data source property.
  • Carthage support.
  • An additional sample project written in Swift (currently in pull request).

License

NYTPhotoViewer is available under the Apache 2.0 license. See the LICENSE.md file for more information.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 84.9%
  • Swift 7.2%
  • Shell 6.0%
  • C 1.1%
  • Ruby 0.8%