Skip to content
This repository has been archived by the owner on Feb 8, 2023. It is now read-only.

alibaba-archive/PhotoBrowser

Repository files navigation

Features

A simple photo browser to display remote photos. Kingfisher is used to download and cache images. Support:

  • Double-tap to zoom out & zoom in
  • Device rotation
  • Full screen mode
  • Long press action
  • Custom toolbar

Installation

Carthage

To integrate PhotoBrowser into your Xcode project using Carthage, specify it in your Cartfile:

$ github "teambition/PhotoBrowser"

Then, run the following command to build the PhotoBrowser framework:

$ carthage update

If Kingfisher is not used in your project, you have to drag it your self into your project from the [Carthage/Build] folder.

Run Demo

$ git clone https://github.com/teambition/PhotoBrowser.git

And then

$ carthage update

Usage

import PhotoBrowser

let photoBrowser = PhotoBrowser

let photo = Photo.init(image: nil, thumbnailImage: thumbnail1, photoUrl: photoUrl1)
let photo2 = Photo.init(image: nil, thumbnailImage: thumbnail2, photoUrl: photoUrl2)
let photo3 = Photo.init(image: nil, thumbnailImage: thumbnail3, photoUrl: photoUrl3)

photoBrowser.photos = [photo, photo2, photo3]

Set toolbarItems property of UIViewController to custom toolbar:

let item1 = UIBarButtonItem.init(barButtonSystemItem: UIBarButtonSystemItem.Bookmarks, target: self, action: nil)
item1.tintColor = UIColor.blackColor()
photoBrowser.toolbarItem = [item1]

When no item specified, toolbar will hide itself.

Implement PhotoBrowserDelegate to receive images long press gesture:

photoBrowser.photoBrowserDelegate = self

func longPressOn(photo: Photo, gesture: UILongPressGestureRecognizer) {
        guard let imageView = gesture.view as? UIImageView else {
            return
        }
        let alertController = UIAlertController.init(title: nil, message: nil, preferredStyle: UIAlertControllerStyle.ActionSheet)
        let cancelAction = UIAlertAction.init(title: "Cancel", style: UIAlertActionStyle.Cancel, handler: nil)
        let saveAction = UIAlertAction.init(title: "Save", style: UIAlertActionStyle.Default) {[unowned self] (action) -> Void in
            if let image = imageView.image {
                self.saveToAlbum(image)
            }
        }
        alertController.addAction(saveAction)
        alertController.addAction(cancelAction)
        self.photoBrowser?.presentViewController(alertController, animated: true, completion: nil)
    }

To-Do

  • Support datasource to provide data
  • Support Block-syntax for long press gesture

License

PhotoBrowser is released under the MIT license. See LICENSE for details.