SCStackViewController

SCStackViewController is a container view controller which allows you to stack other view controllers on the top/left/bottom/right of the root and build custom transitions between them while providing correct physics and appearance calls. It was build with the following points in mind:

1. Simple to understand and modify
2. Left/right OR top/bottom stacking
3. Correct physics
4. Correct appearance calls
5. Customizable transitions
6. Pagination
7. Customizable interaction area
8. Completion blocks for everything

Change Log v2.1.0

• Added ability to stack view controllers either on top or below the root view controller
• Exposed minimum and maximum number of touches properties
• Switched run loop modes for better integration with other scroll views

Change Log v2.0.0

• Integrated MOScrollView for better control over scroll animation and duration
• Added pagedNavigation (exposed continuousNavigation property. Defaults to false). Swiping will bounce at every page and multiple swipes will be required to navigate through more than 1 page
• Added delegate for callbacks when a view controller was shown or hidded and when the Stack's scroll content offset was changed
• Fixed pop animation which now goes through the layouters
• Fixed appearance calls so that they inform the correct view controllers and work while scrolling/tracking.
• Proper reversed stacking implementation
• Fixed parallax layouter to work for the first view controllers
• Added iOS 5.x support
• Added documentation
• Exposed animation duration (defaults to 0.25f)
• Exposed timing function (defaults to kCAMediaTimingFunctionEaseInEaseOut)
• Exposed scroll view bounces property (defaults to YES)
• Exposed scroll indicator visiblity control (defaults to not visible)
• Exposed pagingEnabled property
• Exposed root view controller as readonly

Implementation details

SCStackViewController is build on top of an UIScrollView which gives us the physics we need, content insets for all the 4 positions, callbacks for linking the custom transitions to and easy to build pagination. By overriding the scrollView's shouldReceiveTouch: method we also get the customizable interaction area.

The stack itself relies on layouters to know where to place the stacked controllers at every point. They are build on top of a simple protocol and the demo project contains 6 examples with various effects.

Examples

Plain Stack Layouter

It places the view controllers to their final position and doesn't modify them while dragging.

Reversed Stack Layouter

Reverses the direction used in the plain layouter

Sliding Stack Layouter

It reveals every new controller from beneath the previous one through sliding

Parallax Stack Layouter

Add a nice parallax effect while revealing the stacked controllers

GoogleMaps Stack Layouter

The effect seen in the Google Maps app when opening the drawer

MerryGoRound Stack Layouter

Just something I was playing with.. :)

Usage

• Import the stack into your project

#import "SCStackViewController.h"

• Create a new instance

stackViewController = [[SCStackViewController alloc] initWithRootViewController:rootViewController];

• Set a touch refusal area (optional)

[stackViewController setTouchRefusalArea:[UIBezierPath bezierPathWithRect:CGRectInset(self.view.bounds, 50, 50)]]

• Register layouters

id<SCStackLayouterProtocol> layouter = [[SCParallaxStackLayouter alloc] init];
[stackViewController registerLayouter:layouter forPosition:SCStackViewControllerPositionLeft];

• Push view controllers

[self.stackViewController pushViewController:leftViewController 
								  atPosition:SCStackViewControllerPositionLeft 
								  	  unfold:NO 
								  	animated:NO 
								  completion:nil];

######Check out the demo project for more details.

License

SCStackViewController is released under the MIT License (MIT) (see the LICENSE file)

Contact

Any suggestions or improvements are more than welcome. Feel free to contact me at [email protected] or @stefanceriu.