TheSidebarController
TheSidebarController is a container view controller that manages 3 main view controllers namely - contentViewController, leftSidebarController and the rightSidebarController. Reveal the sidebar by calling either one of the following methods:
Presentation Methods
presentLeftSidebarViewController- presents the left sidebar using the default Facebook type animationpresentLeftSidebarViewControllerWithStyle:- presents the left sidebar by specifying one of the available presentation stylespresentRightSidebarViewController- presents the right sidebar using the default Facebook type animationpresentRightSidebarViewControllerWithStyle:- presents the right sidebar by specifying one of the available presentation styles
Transition Styles
SidebarTransitionStyleFacebook- Content slides to reveal sidebarSidebarTransitionStyleAirbnb- Content rotates in 3D space to reveal sidebarSidebarTransitionStyleLuvocracy- Content zooms out to reveal sidebarSidebarTransitionStyleFeedly- Sidebar slides over contentSidebarTransitionStyleFlipboard- Sidebar slides over while content zooms outSidebarTransitionStyleWunderlist- Content and sidebar slide making a parallax effect
Delegation Methods
sidebarController:willShowViewController:sidebarController:didShowViewController:sidebarController:willHideViewController:sidebarController:didHideViewController:
This project is inspired by RESideMenu. I almost copied everything. Thanks Roman! :)
Installation
Manual
Drag and drop TheSidebarController folder into your project. Add #import "TheSidebarController.h" to all view controllers that need to use it.
Cocoapods
Cocoapods is amazing. If you're still not using it, start now! This is the recommended approach to manage your dependencies. Learn from their official website: http://guides.cocoapods.org/
In the project folder where .xcodeproj resides, create a Podfile:
$ touch Podfile
Edit Podfile and add TheSidebarController:
platform :ios, '7.0'
pod 'TheSidebarController', '~> 0.6'
Install:
$ pod install
Open .xcworkspace and not the .xcodeproj:
$ open MyApp.xcworkspace
Import TheSidebarController where needed:
#import <TheSidebarController/TheSidebarController.h>
Sample Usage
In your AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
ContentViewController *contentViewController = [[ContentViewController alloc] init];
UINavigationController *contentNavigationController = [[UINavigationController alloc] initWithRootViewController:contentViewController];
LeftSidebarViewController *leftSidebarViewController = [[LeftSidebarViewController alloc] init];
RightSidebarViewController *rightSidebarViewController = [[RightSidebarViewController alloc] init];
TheSidebarController *sidebarController = [[TheSidebarController alloc] initWithContentViewController:contentNavigationController
leftSidebarViewController:leftSidebarViewController
rightSidebarViewController:rightSidebarViewController];
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
self.window.backgroundColor = [UIColor whiteColor];
self.window.rootViewController = sidebarController;
[self.window makeKeyAndVisible];
return YES;
}
Present the sidebar view controller
[self.sidebarController presentLeftSidebarViewControllerWithStyle:SidebarTransitionStyleFacebook];
Dismiss the sidebar view controller
[self.sidebarController dismissSidebarViewController];
Replace content view controller
self.sidebarController.contentViewController = [[UIViewController alloc] init];
Requirements
- Xcode 5 or higher
- iOS 7.0 or higher
- ARC
Demo
Build and run the Examples/Basic and Examples/KitchenSink projects in Xcode to see TheSidebarController in action.
Known Bugs
CATransform3D does not play well with autorotation. A simple 3D rotate screws up view positions when device orientation changes. Would appreciate some help on this.
Feature Requests and Contributing
Forks, patches and other feedback are welcome.
Contact
Jon Danao
License
TheSidebarController is available under the MIT license.
Copyright (c) 2013 Jon Danao (danao.org, jondanao)
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.