MMDrawerController使用簡介

一、 MMDrawerController是一個輕量級的側(cè)邊欄抽屜控件，其支持左側(cè)抽屜和右側(cè)抽屜，可以很好的支持導航控制器，并且支持開發(fā)者對手勢和動畫進行自定義

二、MMDrawerController的使用及相關(guān)設(shè)置 MMDrawerController的使用十分簡單，只需將中心視圖控制器和左邊欄視圖控制器傳入初始化方法即可完成MMDrawerController的創(chuàng)建。示例代碼如下：

UIViewController * leftViewController = [[UIViewController alloc]init];
leftViewController.view.backgroundColor = [UIColor redColor];UIViewController * rightViewController = [[UIViewController alloc]init];
rightViewController.view.backgroundColor = [UIColor greenColor];ViewController * centerViewController = [[ViewController alloc]init];
centerViewController.view.backgroundColor = [UIColor blueColor];
//創(chuàng)建控件
MMDrawerController * rootController = [[MMDrawerController alloc]initWithCenterViewController:centerViewController leftDrawerViewController:leftViewController rightDrawerViewController:rightViewController];
 MMDrawerController中還提供了兩個方法供開發(fā)者創(chuàng)建單側(cè)邊欄，如下：
//只創(chuàng)建帶左側(cè)邊欄的視圖控制器
-(id)initWithCenterViewController:(UIViewController *)centerViewController leftDrawerViewController:(UIViewController *)leftDrawerViewController;
//只創(chuàng)建帶右側(cè)邊欄的視圖控制器
-(id)initWithCenterViewController:(UIViewController *)centerViewController rightDrawerViewController:(UIViewController *)rightDrawerViewController; 
//MMDrawerController中也提供了許多屬性和方法供開發(fā)者進行自定義的設(shè)置，其中可用屬性解析如下：
//設(shè)置左側(cè)邊欄的最大寬度 默認280
@property (nonatomic, assign) CGFloat maximumLeftDrawerWidth;//設(shè)置右側(cè)邊欄的最大寬度 默認280
@property (nonatomic, assign) CGFloat maximumRightDrawerWidth;
//這個是一個只讀屬性，用于獲取可見的左側(cè)邊欄寬度
@property (nonatomic, assign, readonly) CGFloat visibleLeftDrawerWidth;
//這個是一個只讀屬性，用于獲取可見的右側(cè)邊欄寬度
@property (nonatomic, assign, readonly) CGFloat visibleRightDrawerWidth;
//動畫速度，這個參數(shù)的意義是每秒移動多少單位 默認為800/s
@property (nonatomic, assign) CGFloat animationVelocity;
//設(shè)置是否允許回彈效果，如果設(shè)置為YES，當使用手勢進行側(cè)邊欄的開啟時會出現(xiàn)回彈效果
@property (nonatomic, assign) BOOL shouldStretchDrawer;
//獲取當前開啟的側(cè)邊欄類型，MMDrawerSide枚舉如下：
/*typedef NS_ENUM(NSInteger,MMDrawerSide{
            MMDrawerSideNone = 0,//無側(cè)邊欄
            MMDrawerSideLeft,//左側(cè)邊欄
            MMDrawerSideRight, //右側(cè)邊欄
};
*/@property (nonatomic, assign, readonly) MMDrawerSide openSide;
//開啟側(cè)邊欄的手勢模式 MMOpenDrawerGestureMode枚舉意義如下
/*typedef NS_OPTIONS(NSInteger, MMOpenDrawerGestureMode){
            //沒有手勢 此模式為默認模式
            MMOpenDrawerGestureModeNone = 0,
            //在導航欄上拖動時可以打開側(cè)邊欄
            MMOpenDrawerGestureModePanningNavigationBar = 1 << 1,
            //在中心視圖控制器的視圖上拖動時可以打開側(cè)邊欄          
            MMOpenDrawerGestureModePanningCenterView = 1 << 2,
            //在中心視圖控制器的視圖邊緣20個單位內(nèi)拖動時可以打開側(cè)邊欄
            MMOpenDrawerGestureModeBezelPanningCenterView = 1 << 3,
            //自定義手勢 需配合自定義手勢的方法使用
            MMOpenDrawerGestureModeCustom = 1 << 4,
            //所有模式兼容
            MMOpenDrawerGestureModeAll= MMOpenDrawerGestureModePanningNavigationBar |MMOpenDrawerGestureModePanningCenterView |MMOpenDrawerGestureModeBezelPanningCenterView |MMOpenDrawerGestureModeCustom,
};*/
@property (nonatomic, assign) MMOpenDrawerGestureMode openDrawerGestureModeMask;
//關(guān)閉側(cè)邊欄的手勢模式 MMCloseDrawerGestureMode枚舉的意義如下
/*typedef NS_OPTIONS(NSInteger, MMCloseDrawerGestureMode) {
            //沒有關(guān)閉手勢
            MMCloseDrawerGestureModeNone= 0,
            //在導航欄上拖動時可以關(guān)閉側(cè)邊欄  
            MMCloseDrawerGestureModePanningNavigationBar= 1 << 1,
            //在中心視圖控制器上推動時可以關(guān)閉側(cè)邊欄    
            MMCloseDrawerGestureModePanningCenterView= 1 << 2,
            //在中心視圖控制器邊緣20單位內(nèi)拖動是可以關(guān)閉側(cè)邊欄        
            MMCloseDrawerGestureModeBezelPanningCenterView= 1 << 3,
            //點擊導航欄時可以關(guān)閉側(cè)邊欄  
            MMCloseDrawerGestureModeTapNavigationBar = 1 << 4,
            //點擊中心視圖控制器視圖時可以關(guān)閉側(cè)邊欄
            MMCloseDrawerGestureModeTapCenterView= 1 << 5,
            //在側(cè)邊欄視圖上拖動時可以關(guān)閉側(cè)邊欄
            MMCloseDrawerGestureModePanningDrawerView= 1 << 6,
            //自定義關(guān)閉手勢，需要和自定義手勢的方法結(jié)合使用  
            MMCloseDrawerGestureModeCustom= 1 << 7,
            //所有模式兼容
            MMCloseDrawerGestureModeAll = MMCloseDrawerGestureModePanningNavigationBar|MMCloseDrawerGestureModePanningCenterView|MMCloseDrawerGestureModeBezelPanningCenterView|MMCloseDrawerGestureModeTapNavigationBar |MMCloseDrawerGestureModeTapCenterView|MMCloseDrawerGestureModePanningDrawerView|MMCloseDrawerGestureModeCustom,
};*/
@property (nonatomic, assign) MMCloseDrawerGestureMode closeDrawerGestureModeMask;
//設(shè)置側(cè)邊欄顯示時的中心視圖控制器的用戶交互規(guī)則 MMDrawerOpenCenterInteractionMode枚舉意義如下
/*typedef NS_ENUM(NSInteger, MMDrawerOpenCenterInteractionMode) {
            //中心視圖控制器不能進行用戶交互 默認為此枚舉
            MMDrawerOpenCenterInteractionModeNone,
            //中心視圖控制器完全可以進行用戶交互
            MMDrawerOpenCenterInteractionModeFull,
           //中心視圖控制器只有導航可以進行用戶交互 
           MMDrawerOpenCenterInteractionModeNavigationBarOnly,
};*/
@property (nonatomic, assign) MMDrawerOpenCenterInteractionMode centerHiddenInteractionMode;
//設(shè)置是否顯示陰影效果
@property (nonatomic, assign) BOOL showsShadow;
//設(shè)置是否顯示狀態(tài)欄的自定義視圖 只有在iOS7之后可用
@property (nonatomic, assign) BOOL showsStatusBarBackgroundView;
//設(shè)置狀態(tài)欄視圖顏色 只有在iOS7之后可用
@property (nonatomic, strong) UIColor * statusBarViewBackgroundColor; 
//相關(guān)方法解析如下：
//切換側(cè)邊欄的狀態(tài)，drawerSide參數(shù)為要切換的側(cè)邊欄，animated設(shè)置是否有動畫效果，completion會在切換完成后執(zhí)行
//注意：如果在切換一個關(guān)著的側(cè)邊欄時，如果另一個側(cè)邊欄正在開啟狀態(tài)，則此方法不會有任何效果
-(void)toggleDrawerSide:(MMDrawerSide)drawerSide animated:(BOOL)animated completion:(void(^)(BOOL finished))completion;
//關(guān)閉側(cè)邊欄
-(void)closeDrawerAnimated:(BOOL)animated completion:(void(^)(BOOL finished))completion;
//開啟側(cè)邊欄-(void)openDrawerSide:(MMDrawerSide)drawerSide animated:(BOOL)animated completion:(void(^)(BOOL finished))completion;
//更換中心視圖控制器
-(void)setCenterViewController:(UIViewController *)centerViewController withCloseAnimation:(BOOL)closeAnimated completion:(void(^)(BOOL finished))completion;-(void)setCenterViewController:(UIViewController *)newCenterViewController withFullCloseAnimation:(BOOL)fullCloseAnimated completion:(void(^)(BOOL finished))completion;
//設(shè)置左側(cè)邊欄最大寬度
-(void)setMaximumLeftDrawerWidth:(CGFloat)width animated:(BOOL)animated completion:(void(^)(BOOL finished))completion;
//設(shè)置右側(cè)邊欄最大寬度
-(void)setMaximumRightDrawerWidth:(CGFloat)width animated:(BOOL)animated completion:(void(^)(BOOL finished))completion;
//進行側(cè)邊欄的預(yù)覽操作 默認預(yù)覽距離為40個單位
-(void)bouncePreviewForDrawerSide:(MMDrawerSide)drawerSide completion:(void(^)(BOOL finished))completion;
//進行側(cè)邊欄的預(yù)覽操作 可以設(shè)置預(yù)覽距離
-(void)bouncePreviewForDrawerSide:(MMDrawerSide)drawerSide distance:(CGFloat)distance completion:(void(^)(BOOL finished))completion;
//這個方法用于進行視圖側(cè)邊欄視圖出現(xiàn)動畫的自定義
-(void)setDrawerVisualStateBlock:(void(^)(MMDrawerController * drawerController, MMDrawerSide drawerSide, CGFloat percentVisible))drawerVisualStateBlock;
//這個方法用于設(shè)置當一個手勢觸發(fā)完成后的回調(diào)
-(void)setGestureCompletionBlock:(void(^)(MMDrawerController * drawerController, UIGestureRecognizer * gesture))gestureCompletionBlock;
//這個方法用于定義自定義的手勢操作 要將開啟側(cè)邊欄與關(guān)閉側(cè)邊欄的模式設(shè)置為MMOpenDrawerGestureModeCustom和MMCloseDrawerGestureModeCustom才有效
-(void)setGestureShouldRecognizeTouchBlock:(BOOL(^)(MMDrawerController * drawerController, UIGestureRecognizer * gesture, UITouch * touch))gestureShouldRecognizeTouchBlock;
//對于自定義過渡動畫的方法：
-(void)setDrawerVisualStateBlock:(void(^)(MMDrawerController * drawerController, MMDrawerSide drawerSide, CGFloat percentVisible))drawerVisualStateBlock;
//回調(diào)block中會傳遞進來側(cè)邊欄顯示完成的百分比，并且在側(cè)邊欄出現(xiàn)過程中，這個回調(diào)block會被不停刷新調(diào)用，開發(fā)者可以直接在其中對要過渡的屬性進行設(shè)置，例如透明度的漸變動畫，示例如下：
//進行自定義動畫
[rootController setDrawerVisualStateBlock:^(MMDrawerController *drawerController, MMDrawerSide drawerSide, CGFloat percentVisible) {
    UIViewController * sideDrawerViewController;
    if(drawerSide == MMDrawerSideLeft) {
            sideDrawerViewController = drawerController.leftDrawerViewController;
    }else if (drawerSide == MMDrawerSideRight) {
            sideDrawerViewController = drawerController.rightDrawerViewController;
    }
    [sideDrawerViewController.view setAlpha:percentVisible];
}];

三、關(guān)于MMDrawerController的子類 開發(fā)者如果有特殊的需求，也可以通過繼承MMDrawerController來實現(xiàn)自己的側(cè)邊欄控制器類，MMDrawerController框架中提供了一個擴展，在編寫MMDrawerController時，開發(fā)者可以導入MMDrawerController+Subclass.h文件，這個文件中提供了許多控制器的監(jiān)聽方法供開發(fā)者重寫，解析如下：

//出現(xiàn)單擊手勢會回調(diào)的方法 如果要重寫 必須調(diào)用父類的此方法
-(void)tapGestureCallback:(UITapGestureRecognizer *)tapGesture __attribute((objc_requires_super));
//出現(xiàn)滑動手勢會回調(diào)的方法 如果要重寫 必須調(diào)用父類的此方法
-(void)panGestureCallback:(UIPanGestureRecognizer *)panGesture __attribute((objc_requires_super));
//決定是否響應(yīng)某個手勢
-(BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer shouldReceiveTouch:(UITouch *)touch __attribute((objc_requires_super));
//準備展示側(cè)邊欄時調(diào)用的方法
-(void)prepareToPresentDrawer:(MMDrawerSide)drawer animated:(BOOL)animated __attribute((objc_requires_super));
//關(guān)閉側(cè)邊欄時調(diào)用的方法-(void)closeDrawerAnimated:(BOOL)animated velocity:(CGFloat)velocity animationOptions:(UIViewAnimationOptions)options completion:(void (^)(BOOL))completion __attribute((objc_requires_super));
//打開側(cè)邊欄時調(diào)用的方法
-(void)openDrawerSide:(MMDrawerSide)drawerSide animated:(BOOL)animated velocity:(CGFloat)velocity animationOptions:(UIViewAnimationOptions)options completion:(void (^)(BOOL))completion __attribute((objc_requires_super));
//設(shè)備旋轉(zhuǎn)方向時調(diào)用的方法
-(void)willRotateToInterfaceOrientation:(UIInterfaceOrientation)toInterfaceOrientation duration:(NSTimeInterval)duration __attribute((objc_requires_super));
-(void)willAnimateRotationToInterfaceOrientation:(UIInterfaceOrientation)toInterfaceOrientation duration:(NSTimeInterval)duration __attribute((objc_requires_super));

四、一些輔助類 MMDrawerController框架中還提供了一個MMDrawerBarButtonItem的輔助類，這個類可以創(chuàng)建三道杠的菜單按鈕。其中方法如下：

//初始化方法
-(id)initWithTarget:(id)target action:(SEL)action;
//獲取某個狀態(tài)下的按鈕顏色
-(UIColor *)menuButtonColorForState:(UIControlState)state __attribute__((deprecated("Use tintColor instead")));
//設(shè)置某個狀態(tài)的按鈕顏色
-(void)setMenuButtonColor:(UIColor *)color forState:(UIControlState)state __attribute__((deprecated("Use tintColor instead")));
// MMDrawerBarButtonItem繼承自UIBarButtonItem，可以直接在導航欄上使用。

前面有提到，側(cè)邊欄的展現(xiàn)動畫開發(fā)者可以進行自定義，為了使開發(fā)者在使用MMDrawerController時更加方便，MMDrawerController框架中還提供了一個動畫輔助類MMDrawerVisualState，這個類中封裝好了許多動畫效果，開發(fā)者可以直接使用，示例如下：

//使用提供的動畫模板
[rootController setDrawerVisualStateBlock:[MMDrawerVisualState slideAndScaleVisualStateBlock]]; 
//MMDrawerVisualState中所提供的動畫模板列舉如下：
//從后向前漸現(xiàn)
+(MMDrawerControllerDrawerVisualStateBlock)slideAndScaleVisualStateBlock;
//滑動漸現(xiàn)
+(MMDrawerControllerDrawerVisualStateBlock)slideVisualStateBlock;
//立方動畫
+(MMDrawerControllerDrawerVisualStateBlock)swingingDoorVisualStateBlock;
//視差動畫
+(MMDrawerControllerDrawerVisualStateBlock)parallaxVisualStateBlockWithParallaxFactor:(CGFloat)parallaxFactor;

 五、MMDrawerController無法完成的需求 為了確保MMDrawerController庫的輕量級，其作者在設(shè)計時也做了功能上的取舍權(quán)衡，MMDrawerController無法完成以下需求：
    1.上邊欄與下邊欄。
    2.同時展示左邊欄與又邊欄。
    3.無法設(shè)置顯示一個最小的抽屜寬度。
    4.不能支持UITabBarController容器。
    5.不能在中心視圖控制器之上呈現(xiàn)側(cè)邊欄視圖。
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

推薦閱讀更多精彩內(nèi)容

  • 發(fā)現(xiàn) 關(guān)注 消息 iOS 第三方庫、插件、知名博客總結(jié) 作者大灰狼的小綿羊哥哥關(guān)注 2017.06.26 09:4...
    肇東周閱讀 12,198評論 4贊 61
  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 173,025評論 25贊 708
  • 總結(jié)我這二十幾年來有限的人生經(jīng)歷，人呢在遭遇厄運的時候若是不冷靜，會更加的在這個泥沼當中越陷越深。當情緒波折很大，...
    愛笑的姑娘小西閱讀 1,170評論 0贊 0
  • 2016年度之《星辰大海，詩和遠方》，擁抱工作，擁抱世界。每一年對我來說都是新的詩篇，步履匆匆，年年不忘。 不知道...
    大藝術(shù)家kiwi閱讀 2,495評論 1贊 5
  • 九月三十號早上剛上班就收到朋友的信息說他搶到了去西寧的火車票，當時心里一震，去青海是我2017年的愿望之一但一直沒...
    nice_五月閱讀 428評論 1贊 0