A UINavigationController subclass that presents itself a dynamic amount in a view controller using the UIViewControllerAnimatedTransitioning protocol.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 83c63c9 Oct 14, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Example 0.2.0 Jun 13, 2015
Pod
.DS_Store
LGSemiModalNavController.podspec Updated Readme Jun 13, 2015
LICENSE Uploaded Project Jun 13, 2015
README.md Update README.md Oct 13, 2017
lukegeiger-semi-modal-cocoapod.gif New Gif Jun 13, 2015
lukegeiger-semi-modal.gif
lukegeiger-semi-modal.png Added Image Jun 13, 2015

README.md

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.