TestsTested | ✓ |
LangLanguage | Obj-CObjective C |
License | Apache 2 |
ReleasedLast Release | Feb 2017 |
Maintained by Jeff Verkoeyen.
This library makes it possible to create UIViewController transitions using the Material Motion runtime.
Import the framework:
@import MaterialMotionTransitions;
You will now have access to all of the APIs.
Check out a local copy of the repo to access the Catalog application by running the following commands:
git clone https://github.com/material-motion/material-motion-transitions-objc.git
cd material-motion-transitions-objc
pod install
open MaterialMotionTransitions.xcworkspace
The core aspects of this library consist of the following:
An object conforming to TransitionDirector is able to describe the plans that should occur during a UIViewController transition.
TransitionController is what allows you to decide which TransitionDirector should govern a particular transition.
Transition directors govern both the presentation and dismissal of a given view controller. An instance of a director is created each time a transition is initiated and thrown away upon the transition's completion.
Be sure to store the provided MDMTransition object.
Code snippets:
In Objective-C:
@interface <# DirectorName #>TransitionDirector : NSObject <MDMTransitionDirector>
@end
@interface <# DirectorName #>TransitionDirector ()
@property(nonatomic, strong) MDMTransition *transition;
@end
@implementation <# DirectorName #>TransitionDirector
- (instancetype)initWithTransition:(MDMTransition *)transition {
self = [super init];
if (self) {
_transition = transition;
}
return self;
}
- (void)setUp {
}
@end
In Swift:
class <# DirectorName #>TransitionDirector: NSObject, TransitionDirector {
let transition: Transition
required init(transition: Transition) {
self.transition = transition
}
func setUp() {
}
}
Register plans using the transition object's runtime.
Code snippets:
In Objective-C:
- (void)setUp {
[self.transition.runtime addPlan:<#(nonnull NSObject<MDMPlan> *)#> to:<#(nonnull id)#>];
}
In Swift:
func setUp() {
transition.runtime.addPlan(<#T##plan: Plan##Plan#>, to: <#T##Any#>)
}
Every view controller has an associated mdm_transitionController
instance. Set a
TransitionDirector class type on the directorClass
property. When you present the view controller,
an instance of your TransitionDirector class will be created and its setUp
method will be invoked.
Code snippets:
In Objective-C:
<#(nonnull UIViewController *)#>.mdm_transitionController.directorClass = [<# TransitionDirector #>TransitionDirector class];
[self presentViewController:<#(nonnull UIViewController *)#> animated:<#(BOOL)#> completion:<#^(void)completion#>];
In Swift:
<# UIViewController instance #>.mdm_transitionController.directorClass = <# TransitionDirector #>TransitionDirector.self
present(<#T##viewControllerToPresent: UIViewController##UIViewController#>, animated: <#T##Bool#>)
We welcome contributions!
Check out our upcoming milestones.
Learn more about our team, our community, and our contributor essentials.
Licensed under the Apache 2.0 license. See LICENSE for details.