Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ahmetkgunay/akgpushanimator
Easily Push and Pop viewcontroller like Instagram App with Interaction
https://github.com/ahmetkgunay/akgpushanimator
animatedtransitioning instagram popviewcontroller pushviewcontroller swift4 transition
Last synced: 3 months ago
JSON representation
Easily Push and Pop viewcontroller like Instagram App with Interaction
- Host: GitHub
- URL: https://github.com/ahmetkgunay/akgpushanimator
- Owner: ahmetkgunay
- License: mit
- Created: 2017-04-30T19:11:15.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-01T16:51:18.000Z (over 7 years ago)
- Last Synced: 2024-03-14T16:43:45.090Z (11 months ago)
- Topics: animatedtransitioning, instagram, popviewcontroller, pushviewcontroller, swift4, transition
- Language: Swift
- Homepage:
- Size: 4.02 MB
- Stars: 46
- Watchers: 6
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AKGPushAnimator
Easily Push and Pop viewcontroller like Instagram App with Interaction written in pure Swift 4
## 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
```swift
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.
```swift
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
```swift
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:
```swift
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](http://cocoapods.org/) 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](http://cocoapods.org/#get_started) section for more details.
#### Podfile
```ruby
platform :ios, '8.0'
use_frameworks!
pod 'AKGPushAnimator', '~> 1.0.6'
```
### Installation with Carthage
[Carthage](https://github.com/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](https://github.com/Carthage/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.