SCSlidingViewController 1.1.0

SCSlidingViewController 1.1.0

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Dec 2014

Maintained by Unclaimed.


Downloads

Total391
Week0
Month0

Installs

Apps19
Test Targets1
powered by Segment

GitHub

Stars406
Watchers22
Forks70
Issues4
Contributors1
Pull Requests1

Code

Files2
LOCLines of Code 409



  • By
  • Simon Coulton

After seeing the following Dribbble shot, I figured it was probably the best solution for the sliding view controller on iOS7.

Dribble

SCSlidingViewController allows you to set one (or two) view controllers to be full height on iOS7 so that the color behind the statusbar can be controlled, while the top view sits below the status bar as per iOS6.

Usage

In your RootViewController.m, do the following to instantiate the left and right (either can be omitted) sides.

#import "RootViewController.h"
#import "TopViewController.h"
#import "MenuViewController.h"

@interface RootViewController () <SCSlidingViewControllerDelegate>

@end

@implementation RootViewController


- (void)viewDidLoad
{
    // Initial view controller, setup the views to be used.
    [super viewDidLoad];
    self.topViewController = [self.storyboard instantiateViewControllerWithIdentifier:@"Top"];
    self.leftSideViewController = [self.storyboard instantiateViewControllerWithIdentifier:@"Menu"];
    self.rightSideViewController = [self.storyboard instantiateViewControllerWithIdentifier:@"Context"];
}

@end

In your RootViewController.h file, make sure you subclass SCSlidingViewController

#import <UIKit/UIKit.h>
#import "SCSlidingViewController.h"

@interface RootViewController : SCSlidingViewController

@end

From any of your other view controllers, when you want to change the topViewController, simply call:

[self.slidingViewController changeTopViewController:[self.storyboard instantiateViewControllerWithIdentifier:@"YOUR VIEW CONTROLLER NAME"]];

Customizing the top view

The following are exposed (and should be straight forward in terms of functionality).

@property (nonatomic) BOOL allowOverswipe;
@property (nonatomic) int topViewOffsetY;
@property (nonatomic) int peakAmount;
@property (nonatomic) CGFloat peakThreshold;
@property (nonatomic) CGFloat cornerRadius;
@property (nonatomic) CGFloat shadowOpacity;
@property (nonatomic) CGFloat shadowOffsetX;
@property (nonatomic) CGFloat shadowOffsetY;
@property (retain, nonatomic) UIColor *shadowColor;
@property (nonatomic) CGFloat animationDuration;

peakThreshold will affect the panning gesture when opening a side. If the view controller is panned more than the percentage amount of the window frame width minus the visible amount of the view controller when being peaked, the view controller will be displayed, otherwise the top view controller will snap back to the original position.

allowOverswipe prevents the view controller from displaying the opposite side from being viewable when panning.

Events

The following events are called when the top view is changed (but are not triggered via self.topViewController modifications).

- (void)willChangeTopViewController;
- (void)didChangeTopViewController;

Todo

  1. Test on iOS6, though some small preliminary tests have been done and it seems to work.
  2. Ability to round corners of content in UINavigationController