实现IOS动画侧边栏效果框架

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 ```objc 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 ```objc -(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 ```objc -(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 ```objc @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. ```objc [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 ```objc -(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 ```objc [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 ```objc [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 ```objc //****************************** 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 ```objc //****************************** 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. ```objc 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 ```objc -(void)transitionInView:(UIView*)containerView fromView:(UIView*)fromView toView:(UIView*)toView Then to use your ``` custom animator call this method when pushing viewControllers ```objc [self.MenuController pushViewController:anotherController withTransitionAnimator:yourCustomAnimator]; ``` In order to control pop animation just implement the MDMenuViewControllerDelegate method in your content View Controller ```objc -(void)topbarViewDidTapBackButton; ``` A