API to make great custom transitions in one method
Make your modal transition with custom animation. AZTransitions helps you think about creativity, giving specific API methods.
Inside this repository you can try iOS Example
target with example FashionTransition.swift
class:
Podfile
and run pod install
pod 'AZTransitions'
Cartfile
and run carthage update
github "azimin/AZTransitions"
Swift Package Manager
just add it to the dependencies
value of your Package.swift
dependencies: [
.package(url: "https://github.com/azimin/AZTransitions.git", .upToNextMajor(from: "0.26.0"))
]
or clone as a git submodule,
or just copy AZTransitions/Source/CustomModalTransition.swift
into your project.
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.customModalTransition = FashionTransition()
}
or
func show() {
let viewController = UIViewController()
viewController.customModalTransition = 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 durationpresentingViewController
— the presenting view controller (bottom one)presentedViewController
— view controller that is going to be presented (top one)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:
Of course sometimes you want to use diffenret modal presentation styles (for example overCurrentContext
), in this case you can call setCustomModalTransition(customModalTransition: CustomModalTransition, inPresentationStyle: UIModalPresentationStyle)
of UIViewController instead of setting customModalTransition
directly.
You have different properties and methods to help you:
performDismissingTransition(interactive: Bool)
to implement custom transition animation when dismissingfromViewController
/toViewController
in term of Apple transition. They are reversed in presenting and dismissing transitions.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
)