SwipeTableView：搞定半糖首页列表布局效果

这是一个实现类似半糖首页、QQ音乐列表、美丽说首页、格瓦斯电影详情页效果（既能上下滚动，同时又能左右滑动）的控件。

项目地址GitHub：https://github.com/Roylee-ML/SwipeTableView

说起这个项目，还是得谈一下一开始写这个项目的缘由。前一阵子，公司项目首页改版，要求作出半糖首页的效果。看了一眼半糖之后，心中一万只草泥马奔过，怎么会做这种设计？后来，想了一天的时间，终于把大概的实现原理捋顺出来，又花了几天的时间来一步步的实现，解决bug。最后终于可以实现上下与左后滑动同时兼容的效果了。由于只是首页改版，所以只是首页实现了效果，也并没有单独写一个控件，可是，一周之后，悲剧的事发生了：新的产品设计中有几个页面都是这样的设计。好吧，还是乖乖的写个控件吧。于是，就有了SwipeTableView。

先来几张预览吧：

再来说一下实现原理：

最初的设计并没有考虑兼容第三方下拉刷新的问题，所以最初的设计更简洁，扩展性也更好。下面是原理的结构图——

首先，为了实现左右滑动的功能，需要一个view来作为所有单一item的父视图载体，并提供左右滑动的功能，这里没有比UICollectionView再合适的了。所有，我用一个CollectionView作为contentView。

有了CollectionView作为载体之后，就可以把每一个ScrollView作为CollectionView的item平铺了。之后，最关键的问题，也是最难处理的问题，就是在滑动CollectionView的时候，怎样保证前后item能够对齐呢（因为悬停，只有对齐才行）？最后想到的解决办法，就是在cellForItem的方法中，对前后两个item的contentOffset进行adjust一致性调整。这样能实现前后两个item的位置是合理的。

最后一个主要的问题就是，多个item共用一个header与bar的问题。既然共用，最后想到，那就让header与bar与CollectionView一样作为SwipeTableView的子视图，并别在图层最上面。由于是独立的view，之后就要解决当前item滑动同时滚动对header与bar做跟随处理的问题了。在这里，对当前的item进行KVO，在item的contentOffset发生变化的时候，同样改变header与bar的位置，使之总是跟随scrollview的滚动，并在悬停的位置做判断，固定bar的frame的y值。

这样，基本的实现就完成了。同时，SwipeTableView允许自适应contentSize，就是在item的内容很少的时候，也能自适应的调整contentSize，保整至少能够滚动到顶端。

后期，用户的反馈header不能滑动，最后通过UIKitDynamic物理引擎的方式解决了这个问题。参考文章 英文博客

最初开源这个项目并没有想会很多人使用，而后期，实际用到人越来越多，大家也都反映项目不能支持下拉刷新的问题，所以，便有了第二种设计方式——

在这个版本中，跟上面的结构原理是差不多的。由于header与bar是独立的，那么每个item就要为header与bar的空间留出空白。而在第一个设计中，是通过修改增加每个item contentInset的top值来留出顶部的留白。而几乎所有的下拉刷新空间都是不考虑inset，直接设置在content的顶部的，而contentInset是不算内容中的（一般下拉刷新控件rame的y值都是自身高度的负值）。所以，在添加了下拉刷新之后，下拉刷新组件其实是藏在header与bar的下面的，底部也正好跟bar对齐（这里可以通过调整下拉刷新组件的frame，减小y值，来显露下拉组件即可）。

为了方便使用，并且兼容第三方下拉刷新，最后采用，每个item顶部的留白由tableHeaderVeiw代替（CollectionView方面要继承STCollectionView设置collectionHeaderView）。不过这样，item的tableHeaderView就是占用的了，由于考虑项目的简洁性，并没有自定义UIScrollView支持scrollview设置headerview。这样用户完全可以只是通过设置一个宏就可以支持下拉刷新，更加方便

@define ST_PULLTOREFRESH_HEADER_HEIGHT xx

其中xx是指下拉刷新组件RefreshHeader的高度，也就是完全显露RefreshHeader开始刷新的高度（如：MJRefresh 为 MJRefreshHeaderHeight，SVPullToRefresh 为 SVPullToRefreshViewHeight）。

最后在混合模式的时候出现了问题，最终发现，原来UICollectionView不支持通过contentSize属性来改变contentSize。最后只好自定义STCollectionView，即支持设置collectionHeaderView，又可以实现自适应contentSize。关于STCollectionView的使用可以详细看github示例。

最后贴上使用示例：

初始化并设置header与bar

1 2 3 4 5 6

self.swipeTableView = [[SwipeTableView alloc]initWithFrame:[UIScreen mainScreen].bounds]; _swipeTableView.delegate = self; _swipeTableView.dataSource = self; _swipeTableView.shouldAdjustContentSize = YES; _swipeTableView.swipeHeaderView = self.tableViewHeader; _swipeTableView.swipeHeaderBar = self.segmentBar;

实现数据源代理：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

- (NSInteger)numberOfItemsInSwipeTableView:(SwipeTableView *)swipeView {      return  4; } - (UIScrollView *)swipeTableView:(SwipeTableView *)swipeView viewForItemAtIndex:(NSInteger)index reusingView:(UIScrollView *)view {      UITableView * tableView = view;      if  (nil == tableView) {          UITableView * tableView = [[UITableView alloc]initWithFrame:swipeView.bounds style:UITableViewStylePlain];          tableView.backgroundColor = [UIColor whiteColor];          ...      }      // 这里刷新每个item的数据      [tableVeiw refreshWithData:dataArray];      ...      return  tableView; }

STCollectionView使用方法：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55

MyCollectionView.h @interface MyCollectionView : STCollectionView @property (nonatomic, assign) NSInteger numberOfItems; @property (nonatomic, assign) BOOL isWaterFlow; @end MyCollectionView.m - (instancetype)initWithFrame:(CGRect)frame {      self = [ super  initWithFrame:frame];      if  (self) {          STCollectionViewFlowLayout * layout = self.st_collectionViewLayout;          layout.minimumInteritemSpacing = 5;          layout.minimumLineSpacing = 5;          layout.sectionInset = UIEdgeInsetsMake(5, 5, 5, 5);          self.stDelegate = self;          self.stDataSource = self;          [self registerClass:UICollectionViewCell.class forCellWithReuseIdentifier:@ "item" ];          [self registerClass:UICollectionReusableView.class forSupplementaryViewOfKind:UICollectionElementKindSectionHeader withReuseIdentifier:@ "header" ];          [self registerClass:UICollectionReusableView.class forSupplementaryViewOfKind:UICollectionElementKindSectionFooter withReuseIdentifier:@ "footer" ];      }      return  self; } - (NSInteger)collectionView:(UICollectionView *)collectionView layout:(STCollectionViewFlowLayout *)layout numberOfColumnsInSection:(NSInteger)section {      return  _numberOfColumns; } - (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout sizeForItemAtIndexPath:(NSIndexPath *)indexPath {      return  CGSizeMake(0, 100); } - (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout referenceSizeForHeaderInSection:(NSInteger)section {      return  CGSizeMake(kScreenWidth, 35); } - (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout referenceSizeForFooterInSection:(NSInteger)section {      return  CGSizeMake(kScreenWidth, 35); } - (UICollectionReusableView *)stCollectionView:(UICollectionView *)collectionView viewForSupplementaryElementOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath {      UICollectionReusableView * reusableView = nil;      if  ([kind isEqualToString:UICollectionElementKindSectionHeader]) {          reusableView = [collectionView dequeueReusableSupplementaryViewOfKind:UICollectionElementKindSectionHeader withReuseIdentifier:@ "header"  forIndexPath:indexPath];          // custom UI......      } else  if  ([kind isEqualToString:UICollectionElementKindSectionFooter]) {          reusableView = [collectionView dequeueReusableSupplementaryViewOfKind:UICollectionElementKindSectionFooter withReuseIdentifier:@ "footer"  forIndexPath:indexPath];          // custom UI......      }      return  reusableView; } - (NSInteger)numberOfSectionsInStCollectionView:(UICollectionView *)collectionView {      return  _numberOfSections; } - (NSInteger)stCollectionView:(UICollectionView *)collectionView numberOfItemsInSection:(NSInteger)section {      return  _numberOfItems; } - (UICollectionViewCell *)stCollectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath {      UICollectionViewCell * cell = [collectionView dequeueReusableCellWithReuseIdentifier:@ "item"  forIndexPath:indexPath];      // do something .......      return  cell; }

总结

这是我的第一个比较完善的开源项目，在这个项目中，非常感谢使用者的认同与支持。通过这个项目，自己确实学到了很多东西。个人觉得，对于开发者而言，能够参与一个开源项目，并去不断的完善解决问题，从中得到的受益将是非常大的。