zoukankan      html  css  js  c++  java
  • UICollectionView自定义布局教程

    转载自:叶孤城

     
     UICollection这个东西是在iOS6被推出来的,所以如果你的app还在支持iOS5还是老实用TableView吧,要么牛逼的就用ScrollView手撸一个出来

    它 最牛逼的地方就在于,Custom的Layout可以玩出无限可能.举个简单例子,早年有个非常出名的CoverFlow第三方库iCarousel(大 约在13年的时候我非常频繁的使用过它),效果非常炫,但问题是它是用scrollview撸出来的,虽然里面也会cache 一些view来复用,保持流畅性,但是始终没有collectionView + layout来的流畅.而且如果是会玩的程序猿,真的能写出非常炫酷效果的layout.

    首先在 这个地址.把Raywenderlich的start Project下载下来.

    跑一下.效果是这样的.

    blob.png

    效 果没啥稀奇的,就是最简单的UICollectionFlowLayout效果,把一个个的Cell从左到右排,如果右边到屏幕头了,放不下了就跑到下一 行继续从左到右排列一个个Cell.collectionview会根据你有没有设置minimumInteritemSpacing来设置你的每个 cell的最小间距,和minimumLineSpacing来设置一行和一行的最小间距.

    其实,tableView说白了,完全可以自定义一种Layout,通过CollectionView来实现.

    我们浏览一下文件结构.

    blob.png

    Controllers 里没啥好说的,就是一个ViewController.

    Extensions 里写了一个UIImage的分类,用来Decompression,我看了一下,其实是用UIGraphicsGetImageFromCurrentImageContext重新生成了一个UIImage.

    Models里就是一个Photo的model,包括一个图片,一个图片的标题和留言.这个model构成了我们UICollectionViewCell的内容.

    还有一个heightForComment方法,是通过boundingRectWithSize方法来计算文字内容在label里的高度.

    Assets 就是我们的图片资源和文字资源.

    好了,现在我们新建一个类,继承自UICollectionViewLayout(注意,不是UICollectionViewFlowLayout).起名叫PinterestLayout,放在我们的Layout的Group里.

    然后在storyboard里选中我们的CollectionView.如图.

    blob.png

    打开Attributes Inspector,进行如图所示的操作.

    blob.png

    OK,直接跑起来.

    blob.png

    啥都没有!

    blob.png

    啥都没有就对了,你新建了一个Layout,里面啥都没写,肯定没有任何效果.

    Core Layout Process(核心布局的处理过程)

    先看看UICollectionView和UICollectionViewLayout是怎么配合工作的.

    blob.png

    当你继承了一个Layout之后,有三个方法是必须Override得.

    • prepareLayout(): 这个方法是干嘛的?这个方法就是当你的布局快要生效的时候,你会在这个方法里计算好每个Item的position和CollectionView的 size.展开一下,最简便的提升TableView的流畅度的方法是什么?很简单,别在HeightForRow的代理方法里直接计算高度.而是在网络 拉取所有数据之后计算好高度,放在Array里,直接在代理方法里return heightArray[indexPath.row].那么为什么要在prepareLayout里计算每个item的Position,意图也很明显 了.就是别让系统每次滚动的时候再去计算每个Cell的frame.(如何提升tableView的performance去看VVbo的Demo.)

    • collectionViewContentSize(): 这个方法的意思也很简单,就是返回CollectionView的ContentSize.是ContentSize而不是Size.

    • layoutAttributesForElementsInRect(_:): 在这个方法里返回某个特定区域的布局的属性.有点绕是吧,那我简单点说.eg.有一个CollectionView,ContentSize是(320, 1000), size是(320, 400),这时候我滑滑滑,滑到了(0, 544, 320, 400).好,那么在这个区域,有几个Cell,每个Cell的位置都是怎么样的?就是通过这个方法获知的.你不告诉CollectionView,他怎 么知道怎么放cell,对吧.

    好的,我们现在理一下思路.

    看上面那张图,A代表CollectionView,B代表Layout.

    A先问B,我cup(size)是多少,C还是D? - -!.

    B告诉他.

    A又问:我的ContentSize是多少.

    B告诉他.

    A这时候的offSet发生了变化,每滑动一下,A都会问,我现在这个位置,有几个Cell,每个Cell的位置,Transform,是怎样的?

    B告诉他.

    就是这样.

    Calculating Layout Attributes (计算布局的属性)

    好的,正式开始我们的编写Pinterest之旅.

    那么问题来了,现在面临的最棘手的问题是什么?

    注意这张图.

    blob.png

    每个Cell的宽度固定,长度不定.

    这就是整个Layout的核心问题.

    所有的难度都在于,如何获知每个Item的height.

    刚才介绍Photo这个Model,我说了决定Cell高度的只有三个,1.图片高度2title的高度3.内容的高度.

    怎么获取图片的高度和文字的高度?

    代理呗.

    在layout里声明一个PinterestLayoutDelegate

    protocol PinterestLayoutDelegate {
      // 1
      func collectionView(collectionView:UICollectionView, heightForPhotoAtIndexPath indexPath:NSIndexPath, 
          withWidth:CGFloat) -> CGFloat
      // 2
      func collectionView(collectionView: UICollectionView, 
          heightForAnnotationAtIndexPath indexPath: NSIndexPath, withWidth  CGFloat) -> CGFloat
    }

    第一个就是通过代理拿到图片的高度,第二个是通过代理拿到文字的高度.

    通过代理拿到了我们想要的数据,接下来,就是要在prepareLayout里计算item的Frame了.

    直接看代码.

    override func prepareLayout() {
        // 1. Only calculate once
        if cache.isEmpty {
          // 2. Pre-Calculates the X Offset for every column and adds an array to increment the currently max Y Offset for each column
          // 每列宽度
          let columnWidth = contentWidth / CGFloat(numberOfColumns)
          var xOffset = [CGFloat]()
          // 其实就是xOffset就是两个,都是固定的.
          for column in 0 ..< numberOfColumns {
            xOffset.append(CGFloat(column) * columnWidth )
          }
          var column = 0
          var yOffset = [CGFloat](count: numberOfColumns, repeatedValue: 0)
          // 3. Iterates through the list of items in the first section
          for item in 0 ..< collectionView!.numberOfItemsInSection(0) {
            let indexPath = NSIndexPath(forItem: item, inSection: 0)
            // 4. Asks the delegate for the height of the picture and the annotation and calculates the cell frame.
            // 这个width是为了计算comment的长度的.
            let width = columnWidth - cellPadding*2
            let photoHeight = delegate.collectionView(collectionView!, heightForPhotoAtIndexPath: indexPath , withWidth:width)
            let annotationHeight = delegate.collectionView(collectionView!, heightForAnnotationAtIndexPath: indexPath, withWidth: width)
            let height = cellPadding +  photoHeight + annotationHeight + cellPadding
            let frame = CGRect(x: xOffset[column], y: yOffset[column],  columnWidth, height: height)
            let insetFrame = CGRectInset(frame, cellPadding, cellPadding)
            // 5. Creates an UICollectionViewLayoutItem with the frame and add it to the cache
            let attributes = PinterestLayoutAttributes(forCellWithIndexPath: indexPath)
            attributes.photoHeight = photoHeight
            attributes.frame = insetFrame
            cache.append(attributes)
            // 6. Updates the collection view content height
            contentHeight = max(contentHeight, CGRectGetMaxY(frame))
            yOffset[column] = yOffset[column] + height
            column = column >= (numberOfColumns - 1) ? 0 : ++column
          }
        }
      }

    我写了一点注释,方便大家观看.

    • 第一句if cache.isEmpty:判断缓存Item高度的Array是否为空,是空则需要计算.

    • let columnWidth = contentWidth / CGFloat(numberOfColumns):计算每列宽度,每列宽度是固定的,就是collectionView的contentWidth除以 2,三列就除以3. contentWidth就是用CollectionView的Bounds.width - ContentInset里的左和右Inset.

    • var xOffset = [CGFloat]():用来存每个Item的X坐标,其实所有Item的X坐标就只有两个.

    • var yOffset = [CGFloat](count: numberOfColumns, repeatedValue: 0):初始化每列的Item的Y坐标,是一个数组,里面有两个元素.

    Y坐标这个东西有点绕,先看一张图.

    blob.png

    这个CollectionView分为两列,实际上呢?CollectionView里压根就没有列的概念.因为排列的时候始终是从左到右排列.如图.

    blob.png

    但是,现在呢,第二个Cell的Y轴实际上是和第零个Cell的height相关的,而第三个是和第一个相关的.

    所 以yOffset这个数组里存了两个值,当第一列的Cell计算高度的时候,他会去yOffset[0]里拿数据,因为yOffset[0]只存第一列的 上一个cell的height,那么同理,当走到第二列的时候,又会去yOffset[1]里拿第二列的上一个cell的height.

    整个流程他用了这么一句话判断.

    column = column >= (numberOfColumns - 1) ? 0 : ++column.

    仔细研读for循环里的逻辑判断.

    override func prepareLayout() {  // 1
      if cache.isEmpty {    // 2
        let columnWidth = contentWidth / CGFloat(numberOfColumns)    var xOffset = [CGFloat]()    for column in 0 ..< numberOfColumns {
          xOffset.append(CGFloat(column) * columnWidth )
        }    var column = 0
        var yOffset = [CGFloat](count: numberOfColumns, repeatedValue: 0)    // 3
        for item in 0 ..< collectionView!.numberOfItemsInSection(0) {      let indexPath = NSIndexPath(forItem: item, inSection: 0)      // 4
          let width = columnWidth - cellPadding * 2
          let photoHeight = delegate.collectionView(collectionView!, heightForPhotoAtIndexPath: indexPath, 
              withWidth:width)      let annotationHeight = delegate.collectionView(collectionView!,
              heightForAnnotationAtIndexPath: indexPath, withWidth: width)      let height = cellPadding +  photoHeight + annotationHeight + cellPadding      let frame = CGRect(x: xOffset[column], y: yOffset[column],  columnWidth, height: height)      let insetFrame = CGRectInset(frame, cellPadding, cellPadding)      // 5
          let attributes = UICollectionViewLayoutAttributes(forCellWithIndexPath: indexPath)
          attributes.frame = insetFrame
          cache.append(attributes)      // 6
          contentHeight = max(contentHeight, CGRectGetMaxY(frame))
          yOffset[column] = yOffset[column] + height
     
          column = column >= (numberOfColumns - 1) ? 0 : ++column
        }
      }
    }

    继续承接上一篇,在prepareLayout()里的这个计算Item的frame是整个Layout的核心,所以必须要每一段话都读懂才能领会UICollectionViewLayout的核心.

    • var column = 0:这个变量是干吗的呢?我们上文贴过这么一张图.

    我解释过,在这个布局中,所谓列这个概念是人工加上去的.在CollectionView中,没有所谓的竖排的这种列,只有Section和Item(也就是Row).而排列方式总是从左到右,一行排满了到下一行这种方式.

    而我们的第二个Item的Y轴依赖于第0个Item的高度,所以,你也可以看做是第偶数个Item的Y轴总是和上一个偶数Item的高度相关.奇数的Item也类似.

    那么,作者又是怎么计算的呢?

    他采取了另外一种方式,声明了一个yOffset数组,只有两个数值.yOffset[0]记录第一列的上一个Item的height,yOffset[1]记录第二列的上一个Item的height.

    当for循环走到第一列的Item(也就是index为偶数的Item)的时候他就去yOffset[0]里去取,走到第二列的Item(也就是index为奇数的Item)的时候就去yOffset[1]里去拿.

    column就是作者用来判别到底当前循环走到的Item是第一列还是第二列的.

    不信?看这句

    column = column >= (numberOfColumns - 1) ? 0 : ++column

    我们来走一下,column声明时赋值为0.第一个for循环走完之后,这个判断是

    column(现在是0) >= (numberOfColumns(始终为2,因为是定死的只有两列) - 1) ? 0: ++column

    所以第一遍循环完了之后column变成1了,说明第二次要从yOffset[1]里取值了.看懂了么?然后每次循环的时候,column就在0和1之间变啊变.

    其实看懂了这一句,其他的就没什么难度了,无非是从Delegate里拿到图片高度,文字标题高度,文字内容高度,加起来,就是每一个Item的height,然后依据这个Item所在的是第一列,给放到yOffset数组里就行了.

    最后把每一个LayoutAttributes存到数组里,用来以后判断和读取用.以后就不需要再计算了.

    返回布局的ContentSize

    在for循环里,我们每执行一次之后都要做一次这个判断.

    contentHeight = max(contentHeight, CGRectGetMaxY(frame))

    其实cotnentSize的height不就是最后的那个Cell的CGRectGetMaxY(frame).所以可以这么计算.

    override func collectionViewContentSize() -> CGSize {
      return CGSize( contentWidth, height: contentHeight)
    }

    重写layoutAttributesForElementsInRect(_:)

    override func layoutAttributesForElementsInRect(rect: CGRect) -> [AnyObject]? {
      var layoutAttributes = [UICollectionViewLayoutAttributes]()
      for attributes  in cache {
        if CGRectIntersectsRect(attributes.frame, rect) {
          layoutAttributes.append(attributes)
        }
      }
      return layoutAttributes
    }

    这个方法的含义我上一篇已经讲过了,就是每次CollectionView滚动到某个区域的时候,CollectionView需要知道这个区域里的每个Cell的layoutAttributes.

    那我们就用CGRectIntersectsRect这个方法遍历判断有哪些attributes的frame在这个区域里,然后返回给collectionView就行了.

    一个获取Photo的height的代理方法

    func collectionView(collectionView:UICollectionView, heightForPhotoAtIndexPath indexPath:NSIndexPath,
          withWidth CGFloat) -> CGFloat {
        let photo = photos[indexPath.item]
        let boundingRect =  CGRect(x: 0, y: 0,  width, height: CGFloat(MAXFLOAT))
        let rect  = AVMakeRectWithAspectRatioInsideRect(photo.image.size, boundingRect)
        return rect.size.height
      }

    这个代理方法是计算Image在contentMode为aspectFit的UIImageView里压缩过之后,如何计算高度的.如果看不懂的可以看武蕴牛X(这个ID真的狂拽炫酷叼霸天)的这篇blog.

    最后一步,修改我们的UICollectionViewCell中的UIImageView的height这个constraint

    override func applyLayoutAttributes(layoutAttributes: UICollectionViewLayoutAttributes!) {
      super.applyLayoutAttributes(layoutAttributes)
      if let attributes = layoutAttributes as? PinterestLayoutAttributes {
        imageViewHeightLayoutConstraint.constant = attributes.photoHeight
      }
    }

    就 是重写CollectionViewCell的这个方法,在每次给我们的Cell赋layoutAttributes之后,拿到我们的Photo高度,然 后把cell的imageViewHeightLayoutConstraint拉一条线,更改Constant属性为layoutAttributes 中的photoHeight就行了.

    完结的项目在这里

    下一期,带领大家做一个英语流利说的这种布局效果的Layout.

  • 相关阅读:
    C++面试考点
    C++面试考点
    C++11 引用叠加规则和模板参数类型推导规则
    C++11 引用叠加规则和模板参数类型推导规则
    C++11 auto和decltype推导规则
    C++11 auto和decltype推导规则
    RVO和NRVO
    RVO和NRVO
    Strange Bank(找零问题)
    eli和字符串 (牛客假期训练)
  • 原文地址:https://www.cnblogs.com/allanliu/p/4774922.html
Copyright © 2011-2022 走看看