美文网首页
[Note] RESideMenu

[Note] RESideMenu

作者: _lemon | 来源:发表于2015-12-05 15:11 被阅读1951次

    第一次读别人的代码选择了这个比较小巧的sidemenu框架。地址在这里:https://github.com/romaonthego/RESideMenu ,有demo很明白地展示框架作用。
    我采用的读代码顺序是从外向内,从应用到内部实现。笔记比较详细繁琐一点。


    RESideMenuExample Folder

    这里面是举例来说明框架的用法。
    在AppDelegate里初始化了sideMenuViewController。初始化需要用到三个VC,中左右分别是navigationController (fistViewController embedded),leftMenuViewController, rightMenuViewController。然后设置了sideMenuViewController的一些属性。还有更多的属性可以设置,这里采用的是default的设置,也就是在sideMenu的viewDidLoad方法里给了各个属性的默认值。
    FirstVC和SecondVC的写法类似。其中navBar的左右按钮的调用方法是写在UIViewController+RESideMenu里。
    SecondVC中加了个Button,buttonType设置的UIButtonTypeRoundedRect没见过,运行也没看到roundedRect,点进去发现已经废弃了,现在用的是UIButtonTypeSystem。
    LeftMenuVC和RightMenuVC写法类似,都是tableVC实现菜单。tableView不是填充整个VC的,按cell个数算好了大小。


    ReSideMenu Folder
    UIViewController+RESideMenu

    这里为UIViewController类多添加了sideMenuViewController属性,并且是只读的。所以刚才LeftMenuVC和RightMenuVC里才能出现self.sideMenuViewController。getter方法的写法就是从树的任何一个节点往上寻根的写法。找到最顶层的RESideMenu为止。

    RECommonFunctions

    这里定义的是一个c语言函数,第一眼没认出来_(:з」∠)_ dispatch_once保证了内容在程序运行时只调用一次,函数目的是为了检测UIKit 是在flat mode还是legacy mode,是通过window的tintColor来确定的。


    RESideMenu

    单独列出来这个最核心的类。

    //RESideMenu.h

    首先是好多好多属性。爆炸。而且都是readwrite的,给用户很大的自由度。
    很多属性有IBInspectable attribute。这是IB的一个便民措施。Swift这里的关键字比较整齐,@IBDesignable和@IBInspectable,在OC中对应的就是IB_DESIGNABLE和IBInspectable。
    IB_DESIGNABLE可以用于自定义view。这样就可以在IB canvas随时看到改动的实际效果。
    IBInspectable是用于属性和变量,也是为了当改变这些属性值的时候,可以在canvas里面所见即所得。
    代理就没什么好说的,监听一下三个view的出现和消失。
    <br />
    //RESideMenu.m

    先看属性。
    visible我理解就是leftMenuVisible || rightMenuVisible,表示的是menu的visible与否。
    originalPoint是用在滑动手势计算偏移量上。
    contentButton是加到contentVC上覆盖整个contentVC的一个隐形Button。在addContentButton方法中可知这个button只会存在一个。点击时调用hideMenuViewController,也就是回到主页面。

    # Instance lifecycle
    commonInit把可以自定义的属性做了个default赋值。

    # Public methods
    setContentViewController:animated:
    这个方法是点击菜单后,回到主页面时调用的。显示的主view做了一个淡入的处理。首先调用hideViewController:方法把contentViewContainer里面原本装的内容移除了,赋值了新的contentVC,这样也就可以满足点击菜单不同项进入不同的内容。 然后调用了didMoveToParentViewController:方法,此方法是需要在VC被添加到containerVC或被移除后调用的。

    # View life cycle
    viewDidLoad
    添加三个VC的过程是:三个VC都添加为self的childVC,两个菜单VC的view都添加到menuViewContainer的subView,主view添加到contentViewContainer的subview,然后各自调用didMoveToParentViewController:方法。
    初始化后三个View重叠在一起。

    # Private methods
    presentMenuViewContainerWithMenuViewController:
    这个是显示左右view之前做的一个预处理。做了一下menuViewContainer的transform和星空背景的伸缩。这里是先对menu做了一个放大的处理,所以出现过程中,是menu由大变正常,主view由正常变小的过程,比突兀地直接按原大小出现更赏心悦目。

    showLeftMenuViewController
    beginAppearanceTransition:方法是通知子控制器自己要出现或消失了。对应的,在completion block里调用了endAppearanceTransition:方法。在自定义container controller时应采取调用这两个方法,而不是viewWillAppear等。
    contentViewContainer直接用transform做了缩小和移动。scale和移动值都是有属性可以自定义的。

    hideViewController:
    首先调用didMoveToParentViewController:,参数传nil表示操作是移除。然后移除view的从属关系,再移除VC的从属关系。

    hideMenuViewControllerAnimated:
    这里主view要出现了,contentButton可以去掉了。
    这里定义了两个block,并注意了用定义weakSelf的方式来避免retain cycle。
    animationBlock是把contentViewContainer的大小等变回到全屏时的状态。
    completionBlock里是状态改变时调用代理方法。
    这样把block抽出来定义的好处是,因为animated参数传入值不定,需要判断。这样写能使代码简洁易懂。

    updateContentViewShadow
    在contentViewContainer.layer上对shadow的属性做一些自定义。是一个定义view的shadow的范例。不看代码还真没注意到还有shadow效果,效果做得还蛮精细的。

    resetContentViewScale
    第一次仔细看CGAffineTransform是怎么实现的。是采用[x y 1] * A的形式。A在文档里有就不写了(其实是不会在markdown里写矩阵啊_(:з」∠)_)。但是这个函数的意义我不是特别明了。这里打印以后发现是单位矩阵,frame前后也没有变。这个函数是在showLeftMenuViewController和showRightMenuViewController里面调用的,调用完后对contentViewContainer进行了缩小和平移操作。所以这个函数似乎是个确保contentViewContainer在原位的函数。那为什么还要特意取出scale做一个伸缩呢,而且这个伸缩在实际运行中就是保持原样的效果。不太理解。

    # iOS 7 Motion Effects
    addMenuViewControllerMotionEffects
    addContentViewControllerMotionEffects
    这两个方法写的是当device的视角倾斜时界面做的一点中心点的位置调整。是比较精致有趣的设计,是在iOS7扁平化设计后才出现的效果。以前没有遇到过,不过看了UIInterpolatinMotionEffect的文档还是比较好懂。

    # UIGestureRecognizer delegate
    gestureRecognizer:shouldReceiveTouch:
    是系统提供的代理方法。对手势做了两个限制。一个是如果contentVC作为navVC而且包含多个VC,则禁用滑动,因为会和系统的swipe to navigate功能冲突。第二是限制了一下手势位置,只有在靠近左边和靠近右边的位置开始滑动才判断有效。

    # Pan gesture recognizer
    panGestureRecognized:
    处理滑动手势的一个函数。比较长。
    首先是得到手势的起始点。然后是在滑动过程中计算delta。delta的计算在主view滑出和滑进还有一点小区别。滑出时delta计算的是手指移动距离在屏宽中占比。滑进时函数中定义的point.x是负值,delta计算的是手指移动距离在主view划出后偏移量中占比。在滑动过程中,所有view的scale变化都是与delta线性相关,是一个很平均平稳的过程。作者很细心地处理了一些边界情况,比如scale过大等。
    在手势完成的部分,根据当前主view的位置,设置threshold做了一个归位处理。设定滑到一定程度停止的话,可以自动完成剩下的滑到规定位置的过程。
    这个函数值得以后再好好看看,手势关联的动画处理还是比较有趣的。

    # ViewController Rotation Handler
    这里做的是如果device横屏了,contentViewContainer的位置需要再偏移得多一些。计算是简单用offset直接加上的。

    相关文章

      网友评论

          本文标题:[Note] RESideMenu

          本文链接:https://www.haomeiwen.com/subject/cfnshttx.html