Need help with AZTransitions?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

azimin
413 Stars 36 Forks MIT License 28 Commits 1 Opened issues

Description

API to make great custom transitions in one method

Services available

!
?

Need anything else?

Contributors list

# 194,362
Swift
macOS
wwdc
osx
11 commits
# 319,237
Swift
Objecti...
Shell
iOS
5 commits
# 10,133
pascal
digest
sha3
instagr...
2 commits
# 118,956
React
HTML
Shell
materia...
1 commit
# 70,652
Ruby
apns
apns2
Rails
1 commit

AZTransitions

CocoaPods Compatible Carthage Compatible SPM Compatible Platform Twitter GitHub license

Make your modal transition with custom animation. AZTransitions helps you think about creativity, giving specific API methods.

Visual Example

Inside this repository you can try

iOS Example
target with example
FashionTransition.swift
class:

Animation example

Installation

  • Add the following to your
    Podfile
    and run
    pod install
    ruby
    pod 'AZTransitions'
    
  • or add the following to your
    Cartfile
    and run
    carthage update
    github "azimin/AZTransitions"
    
  • if you are using
    Swift Package Manager
    just add it to the
    dependencies
    value of your
    Package.swift
    swift
    dependencies: [
    .package(url: "https://github.com/azimin/AZTransitions.git", .upToNextMajor(from: "0.26.0"))
    ]
    
  • or clone as a git submodule,

  • or just copy

    AZTransitions/Source/CustomModalTransition.swift
    into your project.

Code Example

To create any custom transition just subclass

CustomModalTransition
:
class FashionTransition: CustomModalTransition { 
  override init() {
    super.init(duration: 0.5)
  }
}

--

Then set as

az_modalTransition
to nessesary view just before presenting it
override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
  segue.destination.customModalTransition = FashionTransition()
}

or

func show() {
  let viewController = UIViewController()
  viewController.customModalTransition = FashionTransition()
  self.present(viewController, animated: true, completion: nil)
}

--

To have custom present animation, just implement

performTransition(interactive: Bool)
inside your
FashionTransition
class:
func performTransition(interactive: Bool) {
  self.presentedViewController.view.alpha = 0.0

UIView.animate(withDuration: duration, animations: { self.presentedViewController.view.alpha = 1.0 self.presentingViewController.view.alpha = 0.0 }, completion: { (completed) in self.presentingViewController.view.alpha = 1.0 self.finishAnimation(completion: nil) }) }

As you may have guessed, you have different properties. The main ones:

  • duration
    — transition duration
  • presentingViewController
    — the presenting view controller (bottom one)
  • presentedViewController
    — view controller that is going to be presented (top one)

You can animate them as you want.

🔥IMPORTANT🔥 don't forget to call

finishAnimation(completion: nil)
in the end.

In this case animation will be:

Animation code example

UIModalPresentationStyle

Of course sometimes you want to use diffenret modal presentation styles (for example

overCurrentContext
), in this case you can call
setCustomModalTransition(customModalTransition: CustomModalTransition, inPresentationStyle: UIModalPresentationStyle)
of UIViewController instead of setting
customModalTransition
directly.

More

You have different properties and methods to help you:

  • performDismissingTransition(interactive: Bool)
    to implement custom transition animation when dismissing
  • fromViewController
    /
    toViewController
    in term of Apple transition. They are reversed in presenting and dismissing transitions.
  • transitionContainerView
    view where the transition takes place (
    resentingViewController.view
    and
    presentedViewController.view
    located on inside
    transitionContainerView
    ), so you can add your custom views here to make animation more interesting (see
    iOS Example
    )
  • Some methods for interactive animations (example will be added be soon)
  • Some method to work with orientation changing things (example will be added be soon)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.