MDMenuViewController: An Objective-C repository from windgo

MDMenuViewController

MDMenuViewController is an iOS container view controller that coordinates between its content view controllers through a side menu that is shown from the side with appealing animation , supports iOS 6.0 , 7.0 , 8.0 ,iPhone ,And iPad , Customisable in almost every aspect ,provided with documentation ,And a demo app to get you going right away. should be compiled with ARC.

installation

just drag the "MDMenuViewController classes" folder to your project

Basic How to

prepare an NSArray of the content view Controllers

NSArray *viewControllers = [NSArray arrayWithObjects:[[ServicesViewController alloc]
            initWithNibName:@"ServicesViewController" bundle:nil],[[FavouritViewController alloc]
            initWithNibName:@"FavouritViewController" bundle:nil],[[ContactUsViewController alloc]
            initWithNibName:@"ContactUsViewController" bundle:nil],[[AboutViewController alloc]
            initWithNibName:@"AboutViewController" bundle:nil], nil];
            
MDMenuViewController *mainViewC = [[MDMenuViewController alloc] initWithChildViewControllers:viewControllers];

each content view controller maintained by MDMenuViewController must conform to the protocol MDMenuViewControllerDelegate And implementing two required methods

-(NSString*)titleForChildControllerMDMenuViewController:(MDMenuViewController*)menuController

which returns the title of the content view controller to be shown on the top bar and in the side menu

-(NSString*)iconForChildControllerMDMenuViewController:(MDMenuViewController*)menuController

which returns the image name in the bundle you want to show for the content view controller beside its title in side menu , if you wish not to add an icon just return an empty string. and also declare a property

@property(nonatomic,weak)MDMenuViewController *MenuController

alternatively make the content view controllers inherit from MDMenuChildViewController ,and override the MDMenuViewControllerDelegate methods

instantiate MDMenuViewController with the initialisation method
(id)initWithChildViewControllers:(NSArray*)viewControllers and pass it the NSArray of the content view Controllers
show the MDMenuViewController instance.
each content view controller can push other view controllers and pop them again like a UINaviagationController each content view controller is a top view controller in a stack of its own so you can push on its stack other view controllers.

[self.MenuController pushViewController:anotherViewController animated:YES];

you can also control the push transition animation , continue to see how .

you can add a custom top bar left button by implemeting the MDMenuViewControllerDelegate Method

-(UIButton*)leftBarButtonForChildControllerMDMenuViewController:
(MDMenuViewController*)menuController;

and return a cutom UIButton to replace the left top bar button when this content view controller is shown

Customisation Customise the menu Button

you can change the icon of the menu button like the following

[mdMenuControllerInstance.topBar.menuBtn setImage:[UIImage imageNamed:@"side_menu.png"] forState:UIControlStateNormal];
[mdMenuControllerInstance.topBar.menuBtn setImage:[UIImage imageNamed:@"side_menu_active.png"]
          forState:UIControlStateHighlighted];

Customise the Back Button

you can change the icon of the back button like the following

           [mdMenuControllerInstance.topBar.backBtn setImage:[UIImage imageNamed:@"side_menu.png"]
           forState:UIControlStateNormal];
           [mdMenuControllerInstance.topBar.backBtn setImage:[UIImage imageNamed:@"side_menu_active.png"]
           forState:UIControlStateHighlighted];

Customise the top bar

           //****************************** MDMenuViewController customise top bar
           // set main menu button image
           [mdMenuViewControllerInstance.topBar.menuBtn setImage:[UIImage imageNamed:@"menu_icon.png"]
           forState:UIControlStateNormal];
           // set back button image
           [mdMenuViewControllerInstance.topBar.backBtn setImage:[UIImage imageNamed:@"backBtn.png"]
           forState:UIControlStateNormal];
           // set top bar background color
           [mdMenuViewControllerInstance.topBar setBackgroundColor:[UIColor colorWithWhite:0.85 alpha:1.0]];
           // set top bar title text color
           [mdMenuViewControllerInstance.topBar.titleLbl setTextColor:[UIColor whiteColor]];
           // set top bar background image
           mdMenuViewControllerInstance.topBar.backgroundImage.image = [UIImage imageNamed:@"topBar.jpg"];
           //*************************************************************************************************

Customise the side Menu

           //****************************** MDMenuViewController customise menu view
// menu item title text color when selected
         [mdMenuViewControllerInstance.menuView setMenuItemTitleTextColor:[UIColor whiteColor]
         forState:UIControlStateHighlighted];
         // menu item title text color when unSelected
         [mdMenuViewControllerInstance.menuView setMenuItemTitleTextColor:[UIColor whiteColor]
         forState:UIControlStateNormal];
         // menu item background color when unSelected
         [mdMenuViewControllerInstance.menuView setMenuItemBackgroundColor:[UIColor colorWithRed:(46.0f/
         255.0f) green:(46.0f/255.0f) blue:(46.0f/255.0f) alpha:1.0] forState:UIControlStateNormal];
         // menu item background color when selected
         [mdMenuViewControllerInstance.menuView setMenuItemBackgroundColor:[UIColor colorWithRed:(47.0f/
         255.0f) green:(123.0f/255.0f) blue:(154.0f/255.0f) alpha:1.0] forState:UIControlStateHighlighted];
         // menu vie background color
         [mdMenuViewControllerInstance.menuView setBackgroundColor:[UIColor colorWithRed:(46.0f/255.0f)
         green:(46.0f/255.0f) blue:(46.0f/255.0f) alpha:1.0]];
         //disabel ripple animation
         [mdMenuViewControllerInstance.menuView setDisableRippleAnimation:NO];
         //*************************************************************************************************

if you want full control over the content of the side menu view and how its shown , you can create your own menu view provided that it inherits from the base MenuView class and override its interface methods - the base MenuView class is not meant to be used on its own , its just meant to be sub classed - then set your own custom MenuView to the menuView property of your MDMenuViewController instance.

         mdMenuControllerInstance.menuView = yourCustomMenuView;

Customise transition Animations

MDMenuViewController has default animations for push and pop actions , you can make your own animations by declaring your own class that conform to the protocol MDTransitionAnimatorProtocol with only one required method

-(void)transitionInView:(UIView*)containerView fromView:(UIView*)fromView toView:(UIView*)toView Then to use your

custom animator call this method when pushing viewControllers

        [self.MenuController pushViewController:anotherController
         withTransitionAnimator:yourCustomAnimator];

In order to control pop animation just implement the MDMenuViewControllerDelegate method in your content View Controller

-(void)topbarViewDidTapBackButton;

And in the implementation call

         [self.MenuController popViewControllerWithTransitionAnimator:youCustomAnimator];

In general you can show any viewController using the following method

        [self.MenuController showViewController:viewController withTransitionAnimator:yourCustomAnimator];

windgo/MDMenuViewController

MDMenuViewController