一、起源
最近一个朋友需要实现一个UI效果,其实说起来也是很简单的东西,就是:
- 需要实现一个UICollectionView的瀑布流布局。
- 相比较网上不同之处在于,其不止有一个Section。
- SectionHeader需要可以能够实现粘滞的效果。
二、准备
现在网上资料丰富,要实现这个功能并不复杂,自定义UICollectionViewLayout我也相信大家很容易就可以实现,完全不在话下。github也有大把实现了单组瀑布流或者是SectionHeader粘滞效果的的Demo,我也是在别人的肩膀上望远,写下这边博客,权当分享以及自己笔记所用。
下面简单介绍:
** 自定义UICollectionViewLayout有以下几个方法需要重点关照**
- -(CGSize)collectionViewContentSize // 该方法返回的是CollectionView的内容尺寸,UICollectionView继承自UIScrollView,因此必须“告诉”它自己的ContentSize才能确定滚动的范围。
- -(NSArray )layoutAttributesForElementsInRect:(CGRect)rect // 返回rect中的所有的元素的布局属性,其NSArray中保存的对象都是“UICollectionViewLayoutAttributes”*。
- -(UICollectionViewLayoutAttributes*)layoutAttributesForItemAtIndexPath:(NSIndexPath*)indexPath // 该方法返回对应IndexPath位置的Cell布局属性(即UICollectionViewLayoutAttributes对象)。
- -(UICollectionViewLayoutAttributes*)layoutAttributesForSupplementaryViewOfKind:(NSString*)kind atIndexPath:(NSIndexPath*)indexPath // 该方法返回对应IndexPath位置的SupplementaryView布局属性,如果没有SupplementaryView可不实现(包括UICollectionElementKindSectionFooter与 UICollectionElementKindSectionHeader)。
- -(UICollectionViewLayoutAttributes*)layoutAttributesForDecorationViewOfKind:(NSString*)decorationViewKind atIndexPath:(NSIndexPath *)indexPath // 返回对应于indexPath的位置的装饰视图的布局属性,如果没有装饰视图可不实现。
- -(BOOL)shouldInvalidateLayoutForBoundsChange:(CGRect)newBounds // 当边界发生变化时,是否刷新布局(如果返回YES,则每次都会重新计算布局信息)。
首先,程序调用-(void)prepareLayout,在自定有Layout中,一般在该方法中初始需要的参数。
之后,-(CGSize) collectionViewContentSize将被调用,以确定collection应该占据的尺寸。
接下来-(NSArray *)layoutAttributesForElementsInRect:(CGRect)rect被调用,返回UICollectionViewLayoutAttributes来决定UICollectionView这种元素的展现方式和位置等信息。
再细的地方就废话不多说,浪费大家时间,还不明白的朋友请参考:
UICollectionViewLayout Class Reference
ObjC中国-自定义 Collection View 布局
叶孤城:UICollectionView自定义布局教程——Pinterest
喵神-WWDC 2012 Session笔记
三、Just Do It!
代码部分总是没什么说的,因为任何在程序员面前,任何文字都是苍白的,还是“上代码”这三个字来得更铿锵有力:Demo地址
主要有以下地方,简单介绍:
- 如果需要实现SectionHeader的粘滞效果,需要设置layout的needPinSectionHeaders属性为YES,同时可以控制其悬浮的位置,设置distanceFromVisibleTopPosition的数值即可,该属性只有在needPinSectionHeaders=YES的时候才有效,默认为0,实现类似于UITableView的SectionHeader粘滞效果。
- 可以通过delegate或者直接设值的方式来控制显示的部分属性,比如行距,列距,每行显示的列数,显示的内边距等等,如果同时实现,则优先使用delegate中的返回值。这些控制属性并不是必须实现的,其有默认值,可以不必传入。
- 代理中有一个必须实现的方法 -(CGFloat)layout:(HPCollectionViewWaterfallLayout*)layout heightForItemAtIndexPath:(NSIndexPath*)indexPath,其返回的是IndexPath对应位置的Cell的高度。
就只说这么多了。
写在最后
这个Demo完成匆匆,还有很多需要改进的地方,请大家不吝赐教,下载详细代码请点击
,有任何问题欢迎留言或者Email交流(Email:huangpan0422@gmail.com)。
其中SectionHeader粘滞功能参考自SectionHeaders粘滞效果