Skip to content
A custom zooming transition animation for UIViewController
Objective-C Shell Ruby
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Example Fixed pod lint May 4, 2017
Pod Fixed pod lint May 4, 2017
docs Added screen shot gif animation Mar 31, 2015
.gitignore Initial commit Mar 26, 2015
.swift-version Fixed pod lint May 4, 2017
.travis.yml
LICENSE Fix #2 Apr 1, 2015
README.md Modify changelog May 4, 2017
RMPZoomTransitionAnimator.podspec Fixed pod lint May 4, 2017

README.md

RMPZoomTransitionAnimator

Version License Platform

Overview

RMPZoomTransitionAnimator provide a custom transition zooming animation.

Not only UICollectionView, this is possible to use any other UIViewController transition.

This transition animation is like the "Pinterest" animation, but this is very simple and small library.

Screen shot Screen shot

Installation

RMPZoomTransitionAnimator is available through CocoaPods.
To install it, simply add the following line to your Podfile:

pod "RMPZoomTransitionAnimator"

Usage

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

Setup is as below:

Use for an UINavigationController push transition

Refer to the example project for details.

  • Import RMPZoomTransitionAnimator.h
  • Adopt RMPZoomTransitionAnimating
  • Implement the RMPZoomTransitionAnimating protocol below, both source view controller and destination view controller
    1. - (UIImageView *)transitionSourceImageView
    2. - (UIColor *)transitionSourceBackgroundColor
    3. - (CGRect)transitionDestinationImageViewFrame
  • Returns RMPZoomTransitionAnimator instance in the UINavigationController delegate method
- (id <UIViewControllerAnimatedTransitioning>)navigationController:(UINavigationController *)navigationController
                                   animationControllerForOperation:(UINavigationControllerOperation)operation
                                                fromViewController:(UIViewController *)fromVC
                                                  toViewController:(UIViewController *)toVC
{
    // minimum implementation for example
    RMPZoomTransitionAnimator *animator = [[RMPZoomTransitionAnimator alloc] init];
    animator.goingForward = (operation == UINavigationControllerOperationPush);
    animator.sourceTransition = (id<RMPZoomTransitionAnimating>)fromVC;
    animator.destinationTransition = (id<RMPZoomTransitionAnimating>)toVC;
    return animator;
}

Use for a modal transition

Refer to the example project for details.

  • Import RMPZoomTransitionAnimator.h
  • Adopt RMPZoomTransitionAnimating
  • Implement RMPZoomTransitionAnimating protocol below, both source view controller and destination view controller
    1. - (UIImageView *)transitionSourceImageView
    2. - (UIColor *)transitionSourceBackgroundColor
    3. - (CGRect)transitionDestinationImageViewFrame
  • Set the transitioningDelegate in prepareForSegue:sender:
  • Returns RMPZoomTransitionAnimator instance in the UIViewControllerTransitioningDelegate method
- (id<UIViewControllerAnimatedTransitioning>)animationControllerForPresentedController:(UIViewController *)presented
                                                                  presentingController:(UIViewController *)presenting
                                                                      sourceController:(UIViewController *)source
{
    // minimum implementation for example
    RMPZoomTransitionAnimator *animator = [[RMPZoomTransitionAnimator alloc] init];
    animator.goingForward = YES;
    animator.sourceTransition = (id<RMPZoomTransitionAnimating>)source;
    animator.destinationTransition = (id<RMPZoomTransitionAnimating>)presented;
    return animator;
}

- (id<UIViewControllerAnimatedTransitioning>)animationControllerForDismissedController:(UIViewController *)dismissed
{
    // minimum implementation for example
    RMPZoomTransitionAnimator *animator = [[RMPZoomTransitionAnimator alloc] init];
    animator.goingForward = NO;
    animator.sourceTransition = (id<RMPZoomTransitionAnimating>)dismissed;
    animator.destinationTransition = (id<RMPZoomTransitionAnimating>)self;
    return animator;
}

Requirements

  • iOS 7.0 or higher

Change Log

1.0.3

  • Add option to change default animation duration
  • Fixed black screen

1.0.2

  • Remove alpha view and source image view from superview when completed

1.0.1

  • Adds animation completion handler

1.0.0

  • First release.

Contribution

If you have feature requests or bug reports, feel free to help out by sending pull requests or by creating new issues.

Author

Masato Oshima Recruit Marketing Partners Co.,Ltd. recruit_mp_oss@ml.cocorou.jp

License

RMPZoomTransitionAnimator is available under the MIT license.

You can’t perform that action at this time.