README.md

Slide-Drawer

iOS category for UINavigationController which enables a view belonging to a UINavigationController to act as a drawer.

Slide Drawer is a simple drawer implementation which takes a screenshot of the current view controller, pushes the "bottom" drawer view controller into view, and overlays the screenshot of the previous view controller to simulate a drawer. The screenshot then follows the users finger and locks into position. The drawer can slide along 4 different directions(up, down, left, and right).

Adding SlideDrawer to your project:

Just add the following files to your project.

• UINavigationController+PPSlideDrawer.h
  
• UINavigationController+PPSlideDrawer.m
  
• PPSlideDrawerDelegate.h
  

Example of how PPSlideDrawer is used:

Example below, also see MainViewController.m in project.

//Import category
#import "UINavigationController+PPSlideDrawer.h"

- (void)viewDidLoad
{
    [super viewDidLoad];
    [[UIApplication sharedApplication] setStatusBarStyle:UIStatusBarStyleBlackOpaque];
    
    //enable drawer functionality on current view controller
    [self.navigationController enableDrawerFunctionalityForCurrentViewController];
    //set mask to work in all 4 directions
    [self.navigationController setMovementDirectionMask:(DrawerMovementDirectionUp | DrawerMovementDirectionDown | DrawerMovementDirectionLeft | DrawerMovementDirectionRight)];
}

- (void)viewWillAppear:(BOOL)animated{
    //Set slide drawer delegate
    [self.navigationController setSlideDrawerDelegate:self];
}

#pragma mark - PPSlideDrawerDelegate methods
//Delegate method to return which view to display "below" sliding drawer
- (UIViewController*)navigationController:(UINavigationController*)navigationController viewControllerForDrawerMovementDirection:(DrawerMovementDirection)drawerMovementDirection{
    switch (drawerMovementDirection) {
        case DrawerMovementDirectionRight:
            return [[LeftDrawerViewController alloc] init];
            break;
        case DrawerMovementDirectionLeft:
            return [[RightDrawerViewController alloc] init];
            break;
        case DrawerMovementDirectionUp:
            return [[BottomDrawerViewController alloc] init];
            break;
        case DrawerMovementDirectionDown:
            return [[TopDrawerViewController alloc] init];
            break;
        default:
            break;
    }
    
    return nil;
}

//Delegate method, return YES if you want to override the screenshot to overlay
- (BOOL)doesUseAlternateSlideScreenCapture{
    return YES;
}

//If doesUseAlternateSlideScreenCapture returns true, this will be called. 
//Returns custom UI image to use when sliding the drawer
- (UIImage*)alternateSlideScreenCaptureWithOriginalScreenCapture:(UIImage*)originalScreenCapture{
    return originalScreenCapture;
}

TODO

• Implement auto open functionality.
• Implement swipe from edge functionality(rather than just detect panning gesture).
• Landscape support.

License

//
//  Copyright (c) 2013 Patrick Pierson
//  
//  Permission is hereby granted, free of charge, to any person obtaining a copy
//  of this software and associated documentation files (the "Software"),
//  to deal in the Software without restriction, including without limitation the
//  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
//  sell copies of the Software, and to permit persons to whom the Software is
//  furnished to do so, subject to the following conditions:
//  
//  The above copyright notice and this permission notice shall be included in all
//  copies or substantial portions of the Software.
//  
//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
//  INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
//  PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
//  HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
//  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
//  SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//