您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

詳解 iOS 瀑布流佈局:自訂 UICollectionViewLayout

編輯:iOS 相關教學

先看效果演示

特點:瀑布流的總列數可以自由設定(演示為兩列)

雖然 iPhone 自帶的相簿沒有用這種佈局,但瀑布流依然是非常常見的一種排版方式。下面詳細說明實作步驟。

用到的類是 UICollectionView

我們要做的事情是:自訂 UICollectionViewCell 與 UICollectionViewLayout。

     1、自訂 Cell 很簡單,裡面擺一個佔滿整個 cell 的 UIImageView 就好。

     2、重點在自訂 Layout,注意一定要繼承 UICollectionViewLayout,千萬別去繼承 UICollectionViewFlowLayout。

     3、另外還要能算出圖片高度。

為什麼要自訂 UICollectionViewLayout?

因為我們需要逐項指定每個 item 的高度與位置——注意,是真的要親自算每一個 item 的位置。自訂 Layout 必須重寫三個方法,後面會逐一說明。

為什麼要計算圖片高度?

因為寬度固定,只能依圖片原始比例反推高度,這樣圖片才會等比例呈現,不會被拉得奇形怪狀。而且整個 CollectionView 的 contentSize 也得靠這些高度累加得出。

主菜來了

以下內容都寫在自訂的 CustomCollectionViewLayout 類裡。

 //自訂 UICollectionViewLayout 必須重寫的三個方法 //1.計算每個 item 的大小與位置 - (void)prepareLayout; //2.回傳每個 item 的布局屬性 - (nullable NSArray<__kindof UICollectionViewLayoutAttributes *> *)layoutAttributesForElementsInRect:(CGRect)rect; //3.回傳 collectionView 的總高度 - (CGSize)collectionViewContentSize;

可以注意到第三個方法用了 Nullability 與泛型寫法,這是系統方法在 iOS 9 之後補上的新特性。

從這三個方法名就能大致猜到要做什麼。其中第二個方法需要回傳一個陣列,陣列裡放的是布局屬性(UICollectionViewLayoutAttributes)物件,所以我們得先準備一個屬性陣列 attributesArray,把布局屬性裝進去再回傳。

還需要什麼?看過文章開頭的朋友應該注意到了:要能設定列數,就得有個 numberOfColumns 屬性。請注意,因為要在外部設定列數,這個屬性必須寫在自訂類的 .h 檔裡。

另外為了方便,定義一個 itemWidth 表示單項寬度,再定義一個 contentHeight 記錄整個 collectionView 的內容高度。

首先是初始化,這部分沒什麼難處:

 - (instancetype)init { self = [super init]; if (self) { _attributesArray = [NSMutableArray array]; // 預設兩列 _numberOfColumns = 2; _contentHeight = 0.0f; _cellMargin = 5.0f;/**< 間距屬性 */ } return self; }

接著是 getter。itemWidth 其實是固定值,用點語法一路算回來就好:

 - (CGFloat)itemWidth { //所有邊距加總。兩列時有三段間距,三列時有四段 CGFloat allMargin = (_numberOfColumns + 1) * _cellMargin; //扣掉邊距後的可用總寬 CGFloat noMarginWidth = CGRectGetWidth(self.collectionView.bounds) - allMargin; //可用總寬除以列數,就是每一列的寬度(也就是 itemWidth) return noMarginWidth / _numberOfColumns; }

接下來是真正的難點

必須重寫的第一個方法

 - (void)prepareLayout { // 用變數記錄目前最矮的那一列,初始假設第 0 列最矮 #pragma mark - 注意索引是從 0 開始的 #pragma mark - 注意索引是從 0 開始的 // 用陣列記錄每一列的累積高度,因為每放一張圖片高度就會變 NSMutableArray *columnHeightArray = [NSMutableArray array]; // 每一列的初始高度都設為間距 for (int i = 0; i < _numberOfColumns; i++) { [columnHeightArray addObject:@(_cellMargin)]; } // 遍歷 collectionView 第 0 區的所有 item for (int i = 0; i < [self.collectionView numberOfItemsInSection:0]; i++) { //這個後面會用到,先取出來 NSIndexPath *indexPath = [NSIndexPath indexPathForItem:i inSection:0]; // 建立系統要求的布局屬性物件,看參數就知道它代表每個 item 的布局 UICollectionViewLayoutAttributes *layoutAttributes = [UICollectionViewLayoutAttributes layoutAttributesForCellWithIndexPath: indexPath]; // 把布局屬性收進一開始宣告的屬性陣列 [_attributesArray addObject:layoutAttributes]; // 設定每個 item 的位置 (x, y, width, height) // 橫座標起始位置 #pragma mark - 兩列的情況下,新圖片要放到最矮的那一列 #pragma mark - 假設第 0 列最矮,那 x 就從一段間距處開始 #pragma mark - (itemWidth + cellMargin) 視為一個整體單位 CGFloat x = (self.itemWidth + _cellMargin) * shortestColumn + _cellMargin; // 縱座標就是「最矮列」目前累積的高度 CGFloat y = [columnHeightArray[column] floatValue];/**<注意型別轉換 */ // 寬度沒什麼好說的 CGFloat width = self.itemWidth; #pragma mark - 這裡透過自訂協定向外部索取高度 #pragma mark - 把 item 寬度傳給代理(ViewController),由 VC 算好高度後回傳 #pragma mark - 也就是 ↓↓↓ CGFloat height = [self.delegate collectionView:self.collectionView layout:self width:self.itemWidth heightForItemAtIndexPath:indexPath]; // 設定 item 的 frame layoutAttributes.frame = CGRectMake(x, y, width, height); // 放完一個 item,記得更新該列的累積高度 columnHeightArray[shortestColumn] = @([columnHeightArray[shortestColumn] floatValue] + height + _cellMargin); // 整個內容高度取各列的最大值 self.contentHeight = MAX(self.contentHeight, [columnHeightArray[shortestColumn] floatValue]); // 現在再來看哪一列變最矮了 for (int i = 0; i < _numberOfColumns; i++) { //剛剛放圖片那一列的目前高度 CGFloat currentHeight = [columnHeightArray[shortestColumn] floatValue]; //取出第 i 列的累積高度 CGFloat height = [columnHeightArray[i] floatValue]; if (currentHeight > height) { //第 i 列較矮時,最矮列就更新為第 i 列 shortestColumn = i; } } } // 想一想只用上面的程式碼會有什麼問題 // 別慌,先接著往下看 // 提示:這個方法會被呼叫很多次,而陣列是屬性 }

難點結束

沒跟上的朋友建議把上面這段重讀一次,它是整個瀑布流的靈魂。

必須重寫的第二個方法

 // 2.回傳每個 item 對應的布局屬性 - (NSArray<UICollectionViewLayoutAttributes *> *)layoutAttributesForElementsInRect:(CGRect)rect { return _attributesArray; }

必須重寫的第三個方法

 // 3.回傳 CollectionView 的可滾動範圍 - (CGSize)collectionViewContentSize { return CGSizeMake(0, _contentHeight); }

ViewController 裡關於 CollectionView 的建立與協定方法就沒什麼特別之處了。看一下自訂 Layout 的建立與屬性賦值:

 CustomCollectionViewLayout *layout = [[CustomCollectionViewLayout alloc] init]; layout.numberOfColumns = 2;/**< 在 ViewController 裡設定列數,兩列或三列視覺效果最佳 */ layout.delegate = self;/**< 指定 VC 作為高度計算協定的代理 */

再看協定方法在 ViewController.m 中的實作:

 - (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout width:(CGFloat)width heightForItemAtIndexPath:(nonnull NSIndexPath *)indexPath { UIImage *image = _imagesArray[indexPath.row]; // 用傳進來的寬度撐一個足夠高的矩形,高度給 CGFLOAT_MAX 表示只以寬度為基準換算 CGRect boundingRect = CGRectMake(0, 0, width, CGFLOAT_MAX); // 透過系統函數取得最終矩形,記得引入頭檔 // #import <AVFoundation/AVFoundation.h> CGRect imageCurrentRect = AVMakeRectWithAspectRatioInsideRect(image.size, boundingRect); return imageCurrentRect.size.height; }

小結

到這裡,iOS 版的瀑布流佈局就完成了。核心觀念其實就一句話:每次都把新項目放進目前最矮的那一列,然後更新高度紀錄。有興趣的朋友可以動手改改間距、列數,觀察排版變化,會對 UICollectionView 自訂 Layout 的機制理解得更透徹。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved