valeriyvan / AZTransition

API to make great custom transitions in one method

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

AZTransitions

CocoaPods Compatible Carthage Compatible Platform Twitter GitHub license

Make your modal transition with custom animation. AZTransitions helps you think about creativity, giving specific API methods.

Visual Example

Inside this repository you can try iOS Example target with example FashionTransition.swift class:

Animation example

Installation

  • Add the following to your Podfile and run pod install
pod 'AZTransitions'
  • or add the following to your Cartfile and run carthage update
github "azimin/AZTransitions"
  • or clone as a git submodule,

  • or just copy AZTransitions/Source/CustomModalTransition.swift into your project.

Code Example

To create any custom transition just subclass CustomModalTransition:

class FashionTransition: CustomModalTransition { 
  override init() {
    super.init(duration: 0.5)
  }
}

--

Then set as az_modalTransition to nessesary view just before presenting it

override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
  segue.destination.az_modalTransition = FashionTransition()
}

or

func show() {
  let viewController = UIViewController()
  viewController.az_modalTransition = FashionTransition()
  self.present(viewController, animated: true, completion: nil)
}

--

To have custom present animation, just implement performTransition(interactive: Bool) inside your FashionTransition class:

func performTransition(interactive: Bool) {
  self.presentedViewController.view.alpha = 0.0
    
  UIView.animate(withDuration: duration, animations: {
    self.presentedViewController.view.alpha = 1.0
    self.presentingViewController.view.alpha = 0.0
  }, completion: { (completed) in
    self.presentingViewController.view.alpha = 1.0
    self.finishAnimation(completion: nil)
  })
}

As you may have guessed, you have different properties. The main ones:

  • duration — transition duration
  • presentingViewController — the presenting view controller
  • presentedViewController — view controller that is going to be presented

You can animate them as you want.

🔥IMPORTANT🔥 don't forget to call finishAnimation(completion: nil) in the end.

In this case animation will be:

Animation code example

More

You have different properties and methods to help you:

  • performDismissingTransition(interactive: Bool) to implement custom transition animation when dismissing
  • transitionContainerView view where the transition takes place (resentingViewController.view and presentedViewController.view located on inside transitionContainerView), so you can add your custom views here to make animation more interesting (see iOS Example)
  • Some methods for interactive animations (example will be added be soon)
  • Some method to work with orientation changing things (example will be added be soon)

About

API to make great custom transitions in one method

License:MIT License


Languages

Language:Swift 92.2%Language:Ruby 4.7%Language:Objective-C 3.1%