Skip to content

Easily Push and Pop viewcontroller like Instagram App with Interaction

License

Notifications You must be signed in to change notification settings

ahmetkgunay/AKGPushAnimator

Repository files navigation

AKGPushAnimator

Language MIT License Carthage Twitter: @ahmtgny

Easily Push and Pop viewcontroller like Instagram App with Interaction written in pure Swift 4

Anim

Import Library To Your Class

If you are using Carthage to install AKGPushAnimator, then you need to import AKGPushAnimatorKit where you want to use. Because "Carthage" needs Embedded Framework to install libraries, and AKGPushAnimatorKit is the embedded library name of this project.

If you are using Cocoapods to install AKGPushAnimator, then you need to import AKGPushAnimator where you want to use it.

Usage

Usage is simple with creating any BaseViewController and implement UINavigationControllerDelegate

class BaseViewController: UIViewController, UINavigationControllerDelegate {

    let pushAnimator = AKGPushAnimator()
    let interactionAnimator = AKGInteractionAnimator()

    override func viewDidLoad() {
        super.viewDidLoad()
    }
    
    func navigationController(_ navigationController: UINavigationController, animationControllerFor operation: UINavigationControllerOperation, from fromVC: UIViewController, to toVC: UIViewController) -> UIViewControllerAnimatedTransitioning? {

        if operation == .push {
            interactionAnimator.attachToViewController(toVC)
        }
        pushAnimator.isReverseTransition = operation == .pop
        return pushAnimator
    }

    func navigationController(_ navigationController: UINavigationController, interactionControllerFor animationController: UIViewControllerAnimatedTransitioning) -> UIViewControllerInteractiveTransitioning? {

        return interactionAnimator.transitionInProgress ? interactionAnimator : nil
    }
}

After that, create any ViewController inheritted from BaseViewController and set navigationcontroller delegate before pushing viewcontroller (in prepare for segue for best)

And Thats all! Now you have interactive push and pop animation like Instagram App.

class FirstViewController: BaseViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        pushAnimator.delegate = self
    }

    override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
        if segue.identifier == "showSecond" {
            navigationController?.delegate = self
        }
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
    }
}

Delegation Pattern

extension FirstViewController: AKGPushAnimatorDelegate {

    func beganTransition() {
        print("began transition")
    }

    func cancelledTransition() {
        print("cancelled transition")
    }

    func finishedTransition() {
        print("finished transition")
    }
}

Customise Animation with constants

AKGPushAnimator has constants file to easily change animation types:

struct Common {
    static let duration = 0.27;
    static let dismissPosition : CGFloat = -50;
    static let shadowOpacity : Float = 1
    static let shadowColor : UIColor = .black
}

struct Push {
    static let animateOption = UIViewAnimationOptions.curveEaseOut

}

struct Pop {
    static let animateOption = UIViewAnimationOptions.curveEaseInOut
}

Installation

There are three ways to use AKGPushAnimator in your project:

  • using CocoaPods
  • using Carthage
  • by cloning the project into your repository

Installation with CocoaPods

CocoaPods is a dependency manager for Swift and Objective-C, which automates and simplifies the process of using 3rd-party libraries in your projects. See the Get Started section for more details.

Podfile

platform :ios, '8.0'
use_frameworks!
pod 'AKGPushAnimator', '~> 1.0.6'

Installation with Carthage

Carthage is a lightweight dependency manager for Swift and Objective-C. It leverages CocoaTouch modules and is less invasive than CocoaPods.

To install with carthage, follow the instruction on Carthage

Cartfile

github "ahmetkgunay/AKGPushAnimator" ~> 1.0.6

Author

Ahmet Kazım Günay, [email protected]

License

AKGPushAnimator is available under the MIT license. See the LICENSE file for more info.