https://github.com/simoncoulton/SCSlidingViewController

A UIViewController that replicates similar functionality to ECSlidingViewController
https://github.com/simoncoulton/SCSlidingViewController

Last synced: about 1 month ago
JSON representation

A UIViewController that replicates similar functionality to ECSlidingViewController

• Host: GitHub
• URL: https://github.com/simoncoulton/SCSlidingViewController
• Owner: simoncoulton
• License: mit
• Created: 2013-10-12T04:28:11.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2014-01-13T04:33:41.000Z (almost 11 years ago)
• Last Synced: 2024-10-31T15:51:11.696Z (about 1 month ago)
• Language: Objective-C
• Size: 325 KB
• Stars: 381
• Watchers: 18
• Forks: 58
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome - SCSlidingViewController - A UIViewController that replicates similar functionality to ECSlidingViewController (etc)
• awesome - SCSlidingViewController - A UIViewController that replicates similar functionality to ECSlidingViewController (etc)

README

        
# SCSlidingViewController

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

![Dribble](http://dribbble.s3.amazonaws.com/users/14827/screenshots/1193991/8.png "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 () 

	@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 

	#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

[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/simoncoulton/scslidingviewcontroller/trend.png)](https://bitdeli.com/free "Bitdeli Badge")