/LPThumbnailView

A thumbnail view for iOS to give context to multiple images/videos using thumbnails and counter.

Primary LanguageSwiftMIT LicenseMIT

LPThumbnailView

Banner

A contextual image thumbnail view for iOS.

Features

  • Easy to use
  • Sleek animations
  • Customizeable
  • Written in the latest Swift

Requires

  • iOS 10.0+

Installation

CocoaPods

  1. Install CocoaPods

  2. Add this repo to your Podfile

    target 'Example' do
        # IMPORTANT: Make sure use_frameworks! is included at the top of the file
        use_frameworks!
        pod 'LPThumbnailView'
    end
  3. Run pod install

  4. Open up the .xcworkspace that CocoaPods created

  5. Done!

Carthage

To use with Carthage

  1. Make sure Carthage is installed

    brew install carthage

  2. Add this repo to your Cartfile

    github "luispadron/LPThumbnailView"

  3. Drag the LPThumbnailView.framework from MyProjDir/Carthage/Builds/iOS/LPThumbnailView into the General -> Embeded Binaries section of your Xcode project.

Manually

  1. Simply download the source files from here and drag them into your project.

Usage

Simple animation

// Pick your animation style
thumbnailView.animationStyle = .enterFromRight 
// Simply add an image to the thumbnail view, animation is handled for you!
thumbnailView.addImage(image)

Demo gif 1

Contextual animation

// Create/use an existing image view you would like to be animated to the position of the thumbnail.
let imgView = UIImageView(image: someImage)
// Animation from imgView to thumbnail is handled for you!
// imgView will animate to the correct frame and will be removed from the super view on completion of animation.
thumbnailView.addImageWithContext(imgView)

Demo gif 2

Documentation

Please read the docs here for more information and before posting an issue.

Example Project

Take a look at the example project here