[Note] RESideMenu

第一次读别人的代码选择了这个比较小巧的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直接加上的。

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

推荐阅读更多精彩内容