Latest 0.1.0
Homepage https://github.com/frgallah/MasterTransitions
License MIT
Platforms ios 10.0
Frameworks UIKit
Authors
Transition

CI Status
Version
License
Platform

Introduction

MasterTransitions is a library that contains a collection of custom transitions for view controller. It allows you to create a custom transition with just a few lines of code, making the process of creating custom transitions easy and painless for developers.

Requirements

  • iOS 10.0+
  • Xcode 8.2+
  • Swift 3

Installation

CocoaPods.

To install it, simply add the following lines to your Podfile:

use_frameworks!
pod "MasterTransitions"

Manually

Copy MasterTransitions folder to your Xcode project.

Usage

How to use MasterTransitions to create a custom transition:

Navigation and TabBar Controller

In code

In the root view controller or the first view controller:

  1. Get a reference to your Navigation or TabBar Controller
  2. Create a Navigation or TabBar Controller delegate using Navigation or TabBar Controller, transition type and is Interactive as parameters.
  3. Optional: in your delegate object
    • set the transition duration
    • set the transition direction
  4. Your Done!

Navigation Controller

// In the root view  controller
override func viewDidLoad() {
super.viewDidLoad()
// 1-  Get a reference to your Navigation Controller
guard let navigationController = self.navigationController else {
return
}
// 2- Create a Navigation Controller delegate with :
let navigationControllerDelegate = MTNavigationControllerDelegate.init(navigationController: navigationController, transitionType: .Puzzle1, isInteractive: true)
// 3- Optional: in your delegate object
//     - set the transition duration
//     - set the transition direction
navigationControllerDelegate.duration = 1.4
navigationControllerDelegate.transitionSubType = .LeftToRight
}

TabBar Controller

// In the first view  controller
override func viewDidLoad() {
super.viewDidLoad()
// 1-  Get a reference to your TabBar Controller
guard let tabBarController = self.tabBarController else {
return
}
// 2- Create a tabBar Controller delegate with :
let tabBarControllerDelegate = MTTabBarControllerDelegate.init(tabBarController: tabBarController, transitionType: .Puzzle1, isInteractive: true)
// 3- Optional: in your delegate object
//     - set the transition duration
//     - set the transition direction
tabBarControllerDelegate.duration = 1.4
tabBarControllerDelegate.transitionSubType = .LeftToRight
}

In Interface Builder

if you are using the storyboard only:

  1. Drag an Object from the Object Library to your:
    navigation controller scene
MasterTransitions       
MasterTransitions

or

tabBar controller scene

MasterTransitions       
MasterTransitions
  1. In the Custom Class Inspector of the object set its class to:

MTNavigationControllerDelegate

MasterTransitions       
MasterTransitions

or

MTTabBarControllerDelegate

MasterTransitions       
MasterTransitions
  1. control-drag from the delegate object to:

the navigation controller and set the outlet to navigationController

MasterTransitions       
MasterTransitions

or

the tabBar controller and set the outlet to tabBarController

MasterTransitions       
MasterTransitions
  1. Optional:
    In the Attributes Inspector of the delegate object

    • set the Type as transition type
    • set the Sub Type as transition direction
    • set the Duration as transition durtion
    • set Is Interactive
MasterTransitions       
MasterTransitions

Modal Controller

In code

In the source or presenting view controller:

  1. Create or get a reference to your destination controller
  2. set the modal Presentation Style of your destination controller to full screen
  3. Create a Modal Controller delegate using the destination controller and a transition type as parameters.
  4. Optional:
    • make the transition interactive
    • set the transition duration
    • set the transition direction
  5. Your Done!
// In the source or presenting view  controller:
@IBAction func presentViewControllerModally(_ sender: Any) {
// 1- Create your destination Controller
guard let destinationController = storyboard?.instantiateViewController(withIdentifier: "desVC") as? DestinationViewController else { return }
/* 
or get a reference to your destination controller if you are using prepare for segue function

let destinationController = segue.destination

*/

// 2- set the modal Presentation Style of your destination controller to full screen
destinationController.modalPresentationStyle = .fullScreen
// 3- Create a Modal Controller delegate using the destination controller and a transition type as parameters.
let controllerDelegate = MTModalControllerDelegate.init(destinationController: destinationController, transitionType: .Door2)
// 4- Optional:
// - make the transition interactive
// supply a pan gesture if the destination controller view already has a one, if not do not warry about it, the Modal Controller Delegate will create one for you. 
controllerDelegate.addInteractiveToDestinationController(panGesture: nil)
// - set the transition duration
controllerDelegate.duration = 2
// - set the transition direction
controllerDelegate.transitionSubType = .RightToLeft
// - present the destination controller modally
present(destinationController, animated: true, completion: nil)
}

In Interface Builder

if you using the storyboard only:

  1. In the Attributes Inspector of the destination controller set Presentation to Full Screen
MasterTransitions
  1. Drag an Object from the Object Library to the destination controller scene
MasterTransitions       
MasterTransitions
  1. In the Custom Class Inspector of the object set its class to MTModalControllerDelegate
MasterTransitions       
MasterTransitions
  1. control-drag from the delegate object to the destination controller and set the outlet to destinationController
MasterTransitions       
MasterTransitions
  1. Optional:
    In the Attributes Inspector of the delegate object

    • set the Type as transition type
    • set the Sub Type as transition direction
    • set the Duration as transition durtion
MasterTransitions
  1. Drag a Pan Gesture Recognizer from the Object Library to the destination controller view.
MasterTransitions       
MasterTransitions
  1. In the Attributes Inspector of the Pan Gesture Recognizer set the Minimum and Maximum Touches to 1
MasterTransitions
  1. control-drag from the delegate object to the Pan Gesture Recognizer and set the outlet to panGestureForDismissal
MasterTransitions       
MasterTransitions

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Author

frgallah, [email protected]

License

MasterTransitions is available under the MIT license. See the LICENSE file for more info.

Latest podspec

{
    "name": "MasterTransitions",
    "version": "0.1.0",
    "summary": "Interactive transition library for tabbar, navigation and modal view controller. iOS only.",
    "description": "TODO: Interactive transition library for tabbar, navigation and modal view controller. By using a few lines of code you can get an elegant transition.",
    "homepage": "https://github.com/frgallah/MasterTransitions",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Mohammed Frgallah": "[email protected]"
    },
    "source": {
        "git": "https://github.com/frgallah/MasterTransitions.git",
        "tag": "0.1.0"
    },
    "platforms": {
        "ios": "10.0"
    },
    "source_files": "Sources/**/*.swift",
    "frameworks": "UIKit",
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This