lukegeiger / LGSemiModalNavController

A UINavigationController subclass that presents itself a dynamic amount in a view controller using the UIViewControllerAnimatedTransitioning protocol.
MIT License
409 stars 38 forks source link

LGSemiModalNavController

Version License Platform

WARNING

This repository is no longer maintained.

Purpose & Description

The purpose of the LGSemiModalNavController is to allow you to show a view controller a dynamically set height over another view controller.

The effect this custom transition gives off is that a view partially springs up from the bottom of the screen and into place. The view that gets sprung over, gets scaled down by a customizable amount.

Under The Hood

There are two classes that play together to make this happen. the LGSemiModalNavViewController and the LGSemiModalTransition. The LGSemiModalNavViewController subscribes to the UIViewControllerTransitioningDelegate. The LGSemiModalTransition subscribes to UIViewControllerAnimatedTransitioning.

// LGSemiModalNavViewController.m

- (id<UIViewControllerAnimatedTransitioning>)animationControllerForPresentedController:(UIViewController *)presented
                                                                  presentingController:(UIViewController *)presenting
                                                                      sourceController:(UIViewController *)source {
    return [self transitionPresenting:YES];
}

- (id<UIViewControllerAnimatedTransitioning>)animationControllerForDismissedController:(UIViewController *)dismissed {
    return [self transitionPresenting:NO];
}

-(LGSemiModalTransition*)transitionPresenting:(BOOL)presenting{
    LGSemiModalTransition *animator = [LGSemiModalTransition new];
    animator.presenting = presenting;
    animator.tapDismissEnabled = _tapDismissEnabled;
    animator.animationSpeed = _animationSpeed;
    animator.backgroundShadeColor = _backgroundShadeColor;
    animator.scaleTransform = _scaleTransform;
    animator.springDamping = _springDamping;
    animator.springVelocity = _springVelocity;
    animator.backgroundShadeAlpha = _backgroundShadeAlpha;
    return animator;
}

Example

    //This is an example.
    LGViewController *lgVC = [[LGViewController alloc]initWithFormat:LGViewControllerFormatGoBack];

    //This is the nav controller
    LGSemiModalNavViewController *semiModal = [[LGSemiModalNavViewController alloc]initWithRootViewController:lgVC];
    //Make sure to set a height on the view controller here.
    semiModal.view.frame = CGRectMake(0, 0, self.view.frame.size.width, 400);

    //Selected customization properties, see more in the header of the LGSemiModalNavViewController
    semiModal.backgroundShadeColor = [UIColor blackColor];
    semiModal.animationSpeed = 0.35f;
    semiModal.tapDismissEnabled = YES;
    semiModal.backgroundShadeAlpha = 0.4;
    semiModal.scaleTransform = CGAffineTransformMakeScale(.94, .94);

    [self presentViewController:semiModal animated:YES completion:nil];

Usage

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

Installation

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

pod "LGSemiModalNavController"

Authors

Special thanks to Mathew Piccinato who helped develop this with me!

Luke Geiger, @lukejgeiger

Mathew Piccinato, @mpiccinato

License

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