Default Animations

Starting with 0.3.0. Hero provides several default transitions. These can also be customized & combined with your custom heroID & heroModifiers. Makes transitions even easier to implement.

      

Methods for changing the default animations

Use Hero.shared object to interact and change the default animation for your next transition.

  /// Turn off built-in animation for next transition
  func disableDefaultAnimationForNextTransition()

  /// Set the default animation for next transition
  /// This usually overrides rootView's heroModifiers during the transition
  ///
  /// - Parameter animation: animation type
  func setDefaultAnimationForNextTransition(_ animation: HeroDefaultAnimationType)

  /// Set the container color for next transition
  ///
  /// - Parameter color: container color
  func setContainerColorForNextTransition(_ color: UIColor?)

Supported default animations

Please checkout HeroDefaultAnimations.swift for supported animations.

Many of these animations support directions(up, down, left, right).

.auto Animation Type

.auto is the default animation type. It uses the following animations depending on the presentation style:

• .none if source root view or destination root view have existing animations (defined via heroID or heroModifiers).
• .push & .pull if animating within a UINavigationController.
• .slide if animating within a UITabbarController.
• .fade if presenting modally.
• .none if presenting modally with modalPresentationStyle == .overFullScreen.

.selectBy(presenting:, dismissing:) Animation Type

Will determine the animation type by whether or not we are presenting or dismissing.

For example:

.selectBy(presenting:.push(.left), dismissing:.pull(.right))

Will use left push animation if presenting a VC, or right pull animation when dismissing a VC.

Note

Other than .auto & .none, default animations will override heroModifiers on source & destination root views during the transition.