Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cocoatoucher/aicustomviewcontrollertransition
Easy and tidy way for creating custom UIViewController transitions for iOS
https://github.com/cocoatoucher/aicustomviewcontrollertransition
cocoapod custom gesture interactive percent-driven presentation presenter swift swift-3 tidy transition transitioning uiviewcontroller viewcontroller
Last synced: about 1 month ago
JSON representation
Easy and tidy way for creating custom UIViewController transitions for iOS
- Host: GitHub
- URL: https://github.com/cocoatoucher/aicustomviewcontrollertransition
- Owner: cocoatoucher
- License: mit
- Created: 2016-08-07T12:20:07.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-01-29T15:49:59.000Z (almost 8 years ago)
- Last Synced: 2024-10-12T14:40:32.268Z (about 1 month ago)
- Topics: cocoapod, custom, gesture, interactive, percent-driven, presentation, presenter, swift, swift-3, tidy, transition, transitioning, uiviewcontroller, viewcontroller
- Language: Swift
- Size: 19.2 MB
- Stars: 139
- Watchers: 9
- Forks: 17
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AICustomViewControllerTransition
Easy and tidy way for creating custom UIViewController transitions for iOS
Create view controller transitions with no limits and without the complexity of implementing UIViewControllerAnimatedTransitioning protocol or subclassing UIPercentDrivenInteractiveTransition. You just need to use provided transitioningDelegate closure callbacks and provide your UIView animation code.
[](https://developer.apple.com/iphone/index.action)
[](https://developer.apple.com/swift)
[](http://mit-license.org)
   
Drag Down icon used in examples and screenshots is by IconMafia from thenounproject.com (https://thenounproject.com/search/?q=drag&i=463918)
##Requirements
- iOS 8.1+
- Xcode 8 (Use pod version 1.0.3 for Xcode 7)
## Installation
> **Embedded frameworks require a minimum deployment target of iOS 8.1**
>
> To use with a project targeting iOS 7, or if you don't want to use CocoaPods you must include the `AICustomViewControllerTransition.swift` source file directly in your project.
>
---
## Usage
### 1. Create a custom transitioning delegate object
- SimpleTransitioningDelegate
If you don't want your transition to be interactive
```swift
let mySimpleTransitioningDelegate = SimpleTransitioningDelegate()
```
- InteractiveTransitioningDelegate
If you want your transition to be interactive as well. Includes all the functionality of SimpleTransitioningDelegate
```swift
let myInteractiveTransitioningDelegate = InteractiveTransitioningDelegate()
```
### 2. Assign animation closures to your transitioning delegate
- transitionPresent
Animate transition for presenting your modal view controller. See SimpleTransitionViewController example in the Example project.
```swift
mySimpleTransitioningDelegate.transitionPresent = { [weak self] (fromViewController: UIViewController, toViewController: UIViewController, containerView: UIView, transitionType: TransitionType, completion: @escaping () -> Void) in
UIView.animate(withDuration: animationDuration, animations: {
// Your custom presentation animation here
// Use provided viewController views to animate
}, completion: { (finished) in
// Do't forget to execute completion closure
completion()
})
}
```
- transitionDismiss
Animate transition for dismissing your modal view controller. See SimpleTransitionViewController example in the Example project.
```swift
mySimpleTransitioningDelegate.transitionDismiss = { [weak self] (fromViewController: UIViewController, toViewController: UIViewController, containerView: UIView, transitionType: TransitionType, completion: @escaping () -> Void) in
UIView.animate(withDuration: animationDuration, animations: {
// Your custom dismissal animation here
// Use provided viewController views to animate
}, completion: { (finished) in
completion()
})
}
```
- transitionPercentPresent
Animate percent driven interactive transition for presenting your modal view controller. See PanToViewTransitionViewController and ExpandingCellsTableViewController examples in the Example project.
```swift
myInteractiveTransitioningDelegate.transitionPercentPresent = {[weak self] (fromViewController: UIViewController, toViewController: UIViewController, percentage: CGFloat, containerView: UIView) in
// Animate your view controllers using provided percentage
// Because the transition is progressive, you probably don't need an animation block here
}
```
- transitionPercentDismiss
Animate percent driven interactive transition for dismissing your modal view controller. See PanToViewTransitionViewController and ExpandingCellsTableViewController examples in the Example project.
```swift
myInteractiveTransitioningDelegate.transitionPercentDismiss = {[weak self] (fromViewController: UIViewController, toViewController: UIViewController, percentage: CGFloat, containerView: UIView) in
// Animate your view controllers using provided percentage
// Because the transition is progressive, you probably don't need an animation block here
}
```
### 3. Begin, update and finalize a percent driven interactive transition
Use below methods if you are using an InteractiveTransitioningDelegate as your transitioning delegate. See PanToViewTransitionViewController and ExpandingCellsTableViewController examples in the Example project.
- beginPresenting(viewController:fromViewController:) or beginDismissing(viewController:)
Begin presenting your modal view controller, usually in the callback method for a gesture recognizer that your user interacts with.
```swift
myInteractiveTransitioningDelegate.beginPresenting(viewController:myModalViewController, fromViewController:self)
```
- update(_:)
Update the percentage of your transition, usually in the callback method for a gesture recognizer that your user interacts with.
```swift
myInteractiveTransitioningDelegate.update(percentage)
```
- finalizeInteractiveTransition(isTransitionCompleted:)
End presenting or dismissing an interactive transition.
```swift
myInteractiveTransitioningDelegate.finalizeInteractiveTransition(isTransitionCompleted:true)
```
### 4. Present your view controller as usual
If you are not presenting your view controller in an interactive way, present your view controller as usual. Even if you are using an InteractiveTransitioningDelegate you can still choose to present or dismiss your view controller automatically without a progressive interaction from user, e.g. user taps the button only once. See PanToViewTransitionViewController in Example project.
```swift
myModalViewController.modalPresentationStyle = .Custom
myModalViewController.transitioningDelegate = myInteractiveTransitioningDelegate //or mySimpleTransitioningDelegate
self.presentViewController(self.detailViewController, animated: true, completion: nil)
```
## Documentation
http://cocoadocs.org/docsets/AICustomViewControllerTransition/
## License
AICustomViewControllerTransition is released under the MIT license. See LICENSE for details.
youtube, fancy