iOS侧边栏:支持AutoLayout横竖屏/手势/可自定义/多样式

更新:

1.修正了一些笔误和添加了shouldLeftStill,shouldRightStill两个属性,这两个属性可以使侧边栏不移动,而你可以通过RootSplitBuffDelegate协议来控制侧边栏的子视图的移动过程,以实现更丰富的交互**

Method Swizzling 提示(very important):

为确保UINavigationController的pop手势和侧滑手势不冲突,
在使用UINavigationController的pop手势时,对于navigationController.viewControllers的第二个(index为1)的viewController,若重写了viewDidApear: 则必须调用[super viewDidAppear:];

对UIViewController的
“presentViewController:animated:completion:”方法进行了Method-Swizzling,以确保模态视图显示的正确性。如果该swizzling不足以满足需求,用户可根据自行需要进行标准的method-swizzling.

RootSplitBuff依赖FrameBuff(用于快速获取UIView和CALayer的位置和尺寸)

</br>
此侧边栏工具是由BuffKit组件中的RootSplitBuff实现.
Demo地址:https://github.com/FlashHand/BuffKit
或通过pod导入:pod 'BuffKit'

RootSplitBuff 功能:

  1. 支持AutoLayout,横竖屏兼容。
  2. 支持通过左右边缘滑动手势显示或隐藏侧边栏
  3. 支持设置横屏和竖屏显示不同的背景图片
  4. 支持透视3D效果,缩放效果,平移效果,以及自定义
  5. 对左右侧滑手势进行了优先处理
  6. 支持协议回调
  7. 通过修改属性的默认值即可以实现十分丰富的侧边栏效果

效果图:

Perspective风格,竖屏,侧边栏被设为透明

Perspective风格,横屏,侧边栏被设为透明

Covered风格,竖屏

Covered风格,横屏

Scaled风格,竖屏,侧边栏被设为透明

Scaled风格,横屏,侧边栏被设为透明

配置参数:

在 RootSplitBuff中默认值设置为:

_splitStyle=BuffSplitStyleCovered;
_dimColor=[UIColor lightGrayColor];
_dimOpacity=0.5;
_leftWidth=200;
_rightWidth=200;
_leftAnimationDuration=0.3;
_rightAnimationDuration=0.3;
_mainEndOffsetForLeft=0;
_mainEndOffsetForRight=0;
_mainScale=0.8;
_mainRotateAngle=1;

上面这些属性都是可以重写的
注意:_mainEndOffsetForLeft,_mainEndOffsetForRight只会在BuffSplitStyleCovered情况下有效,其他情况下会被忽略。
_mainScale只能用于BuffSplitStyleScaled情况。
_mainRotateAngle只能用于BuffSplitStylePerspective情况,BuffSplitStylePerspective情况下会忽略_leftWidth和_rightWidth

使用示例:

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    CGRect screenBounds=[[UIScreen mainScreen]bounds];
    _window=[[UIWindow alloc]initWithFrame:CGRectMake(0, 0, screenBounds.size.width, screenBounds.size.height)];
    BuffListViewController  *buffListVC=[[BuffListViewController alloc]init];
    [buffListVC setTitle:@"BuffKit"];
    UINavigationController *navi=[[UINavigationController alloc]initWithRootViewController:buffListVC];
//设置横竖屏背景图片
    [[RootSplitBuff rootViewController]setRootBackgroundPortraitImage:[UIImage imageNamed:@"WallPaper.jpg"]];
    [[RootSplitBuff rootViewController]setRootBackgroundLandscapeImage:[UIImage imageNamed:@"WallPaper2.jpg"]];
//设置主视图
    [[RootSplitBuff rootViewController]setBfMainViewController:navi];

    BuffLeftViewController *lvc=[[BuffLeftViewController alloc]init];
    [[RootSplitBuff rootViewController]setBfLeftViewController:lvc];
//激活左边栏滑动手势
    [RootSplitBuff activeLeftPanGesture];
    BuffRightViewController *rvc=[[BuffRightViewController alloc]init];
    [[RootSplitBuff rootViewController]setBfRightViewController:rvc];
//激活右边栏滑动手势
    [RootSplitBuff activeRightPanGesture];
    [_window setRootViewController:[RootSplitBuff rootViewController]];
//设置样式为透视旋转
[[RootSplitBuff rootViewController]setSplitStyle:BuffSplitStylePerspective];
//设置旋转角度
    [[RootSplitBuff rootViewController]setMainRotateAngle:1.2];
//shouldLeftStill,shouldRightStill两个属性,这两个属性可以使侧边栏不移动,而你可以通过RootSplitBuffDelegate协议来控制侧边栏的子视图的移动过程,以实现更丰富的交互
    [RootSplitBuff rootViewController].shouldLeftStill=YES;
    [RootSplitBuff rootViewController].shouldRightStill=YES;
    [_window makeKeyAndVisible];
    return YES;
}

显示侧边栏:

[RootSplitBuff showLeftViewController];
[RootSplitBuff showRightViewController];

Method-swizzling注意:

我对UIViewContoller的"presentViewController:animated:completion:"方法的IMP进行了转换,请注意可能会导致VC的presentingViewController为[RootSplitBuff rootViewController]。所以获取presentingViewController前你需要确定你了解presentingViewController是什么。如果你也对该方法进行IMP转换,请确保你使用的是标准method-swizzling方法,method-swizzling实现如下:

@implementation UIViewController (RootSplitBuff)
#pragma mark UIViewController Method swizzling+forwarding

+ (void)load {
    static dispatch_once_t rootSplitBuffToken;
    dispatch_once(&rootSplitBuffToken, ^{
        Class class = [UIViewController class];
        SEL origSel = @selector(presentViewController:animated:completion:);
        SEL swizSel = @selector(bf_swizzled_presentViewController:animated:completion:);
        Method origMethod = class_getInstanceMethod(class, origSel);
        Method swizMethod = class_getInstanceMethod(class, swizSel);
        BOOL didAddMethod = class_addMethod(class, origSel, method_getImplementation(swizMethod), method_getTypeEncoding(swizMethod));
        if (didAddMethod) {
            class_replaceMethod(class, swizSel, method_getImplementation(origMethod), method_getTypeEncoding(origMethod));
        }
        else {
            method_exchangeImplementations(origMethod, swizMethod);
        }
    });
    
}
-(void)bf_swizzled_presentViewController:(UIViewController *)viewControllerToPresent animated:(BOOL)flag completion:(void (^)(void))completion{
    if (self==[RootSplitBuff rootViewController]) {
        [self bf_swizzled_presentViewController:viewControllerToPresent animated:flag completion:completion];
    }
    else {
        if ([RootSplitBuff rootViewController].isRootViewContollerShowing){
            [[RootSplitBuff rootViewController] bf_swizzled_presentViewController:viewControllerToPresent animated:flag completion:completion];
        }
        else {
            [self bf_swizzled_presentViewController:viewControllerToPresent animated:flag completion:completion];
        }
    }
}
@end

BuffKit包含了对Foundation的扩展以及app常用的基础功能,目前仍在开发中,主干功能不多,但已经稳定可用,其它功能可以前往https://github.com/FlashHand/BuffKithttp://r4l.xyz查看。
如果您有任何问题或建议,欢迎通过简书留言: )

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,376评论 6 491
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,126评论 2 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 156,966评论 0 347
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,432评论 1 283
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,519评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,792评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,933评论 3 406
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,701评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,143评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,488评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,626评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,292评论 4 329
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,896评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,742评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,977评论 1 265
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,324评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,494评论 2 348

推荐阅读更多精彩内容

  • 转至元数据结尾创建: 董潇伟,最新修改于: 十二月 23, 2016 转至元数据起始第一章:isa和Class一....
    40c0490e5268阅读 1,690评论 0 9
  • WebSocket-Swift Starscream的使用 WebSocket 是 HTML5 一种新的协议。它实...
    香橙柚子阅读 23,796评论 8 183
  • github排名https://github.com/trending,github搜索:https://gith...
    小米君的demo阅读 4,558评论 2 38
  • 也许,每个人都能从萧红的身上找到自己的影子,她的单纯,不世故,乐观和坚持自我的写作。她是一位才华横溢的伟大的...
    一乘道阅读 728评论 3 3
  • 今天是星期三,和英俊冷战已经近100个小时。 冷战的滋味真不好受,好像一下子失去了平常可以吐槽可以分享的树洞,心像...
    菜菜緖緖阅读 351评论 0 0