• Stars
    star
    119
  • Rank 297,930 (Top 6 %)
  • Language
    Objective-C
  • License
    MIT License
  • Created about 11 years ago
  • Updated about 11 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A tab bar controller-esque navigation solution for iOS inspired by Creativedash.

BounceMenuController

BounceMenuController is a tab bar controller-esque navigation solution for iOS inspired by Creativedash. An elegant and minimal alternative to UITabBarController.

Animation

Since this project is far from perfect contributions are always welcomed. Feel free to let me know of any bugs you may experience as this has not been used in a production setting. Pull requests are the preferred way to contribute.

Usage

Installation with CocoaPods

platform :ios, "7.0"
pod "BounceMenuController", "~> 0.1.0"

Without CocoaPods

Add BounceMenuController.h, BouceMenuController.m, PlusButton.h, and PlusButton.m files to your project and add the QuartzCore framework to your project.

Code Examples

Initializing and using the BounceMenuController

BounceMenuController *bounceMenuController = [[BounceMenuController alloc] init];

// load view controllers from a storyboard
UIStoryboard *sb = [UIStoryboard storyboardWithName:@"StoryboardiPhone" bundle:nil];
UIViewController *vc1 = [sb instantiateViewControllerWithIdentifier:@"ViewController1"];
UIViewController *vc2 = [sb instantiateViewControllerWithIdentifier:@"ViewController2"];
UIViewController *vc3 = [sb instantiateViewControllerWithIdentifier:@"ViewController3"];

// set the view controllers for the bounce menu
NSArray *controllers = [NSArray arrayWithObjects:vc1, vc2, vc3, nil];
bounceMenuController.viewControllers = controllers;

Any view controller used with BounceMenuController must have its UITabBarItem image set. The image(s) can also be set in your storyboard file.

viewController.tabBarItem.image = [UIImage imageNamed:@"tabBarImage.png"];

You can also customize the background and menu button colors

bounceMenuController.backgroundColor = [UIColor blackColor]
bounceMenuController.menuButtonColor = [UIColor lightGrayColor];

Known Issues

  1. If there are more tabs than vertical space allows (in landscape or otherwise), those tabs cannot be accessed.

Requirements

BounceMenuController requires iOS 5.0 and above.

ARC

BounceMenuController uses ARC as of its 1.0 release.

License

Made available under the MIT License. Attribution would be nice.