SweetBubblesTransition

SweetBubblesTransition is a transition written in swift, based on the adding of child Controllers. It's a sweet animation with bubbles giving an unexpected experience to the users. Bubbles make your life funnier !

Installation

SweetBubblesTransition is available through CocoaPods. To integrate SweetBubblesTransition into your Xcode project using Cocoapods, you have to specify it in your Podfile:

pod 'SweetBubblesTransition'

Usage

This transition is using the Reusable library, made by AliSoftware.

To make you understand it, we will make an overley of controllers.

From the first ViewController you will add the ViewController where you want to transit to (called VC2). Then you have to add on top the BubbleViewController (which will make the transition).

Finally we make the VC2 visible and remove the BubbleVC.

To do it we'll use the StoryboardBased protocol, let's have a look at the procedure:

1. First of all, we'll assume that you just create your project and so you have the Mainstoryboard + one ViewController by default. We will call it the VC1 for the rest of the explanation.

2. Create a new Storyboard called ViewController2 (for exemple) and add to it a new ViewController called by the same name (really important) ViewController2. Now we have our VC2 and don't forget to add to its own class:

// We have to import Reusable
import UIKit
import Reusable

// And add the StoryboardBased protocol
class ViewController2: UIViewController, StoryboardBased {
}

3. That's it for the VC2! Now go to the VC1 swift file and do this:

// Now we can add here SweetBubblesTransition
import UIKit
import SweetBubblesTransition

// Change your VC1's type by AnimationController
class ViewController: AnimationController {

    // You have to instantiate your VC2 by using the method .instantiate() (thanks again to Reusable).
    private let viewController2 = ViewController2.instantiate()

    // Now for this exemple I just created a button on the VC1, and assigned to it the following function
    @IBAction func change(_ sender: Any) {
        // ------------------------------- PARAMETERS INDICATIONS -------------------------------
        // 1. 'to' means the VC you want to transit to.
        // 2. 'animation' is the time of the transition. If you choose 2, for exemple, that means the VC2 will appear in two seconds.
        // 3. 'bubbleController' is the time you want to remove the BubbleViewController.
        // Personnally I think 3sec for the animation and 2.5sec to delete the BubbleVC is the perfect timing, but feel free to make your own opinion !
        startTransition(to: viewController2, animation: 3, bubbleController: 2.5)
    }
}

4. Enjoy !!

Requirements

• iOS 10.0+ target deployment
• Swift 5

Communication

• If you need help, open an issue.
• If you find a bug, open an issue.
• If you have a feature request, open an issue.

Author

Lucas Amelin, [email protected]

License

This code is distributed under the MIT license. Look at the License file for more info.