瀑布流是一種常見的視覺布局,內容方塊依高度差異排列,形成錯落有致的畫面。它最早因 Pinterest 而流行,後來被廣泛應用於圖片牆、商品列表與社群動態。

UICollectionView 是 UITableView 之後更強大的列表元件,除了保留重用機制,還允許開發者自定義 item 的排列方式。只要提供自定義 UICollectionViewLayout,就能決定每個 item 的位置與尺寸。

自定義瀑布流 layout 時,通常需要覆寫 prepareLayout、collectionViewContentSize、layoutAttributesForElementsInRect 與 layoutAttributesForItemAtIndexPath。其中,layoutAttributesForElementsInRect 會被頻繁呼叫,因此應避免重複計算,最好提前建立並缓存布局屬性。
瀑布流的列數、行距、列距、內距與 item 高度,通常可由外部代理提供。由於每張圖片寬高比不同,item 高度往往需要動態計算,因此代理設計特別重要。

為了避免每次呼叫代理時都重複判斷 optional 方法是否實作,可在 prepareLayout 中先檢查一次,並用結構體保存結果。後續只需要讀取旗標,即可提升效能。
核心思路是:先算出 item 寬度,再找出目前最短的一列,把新 item 放在該列的底部。接著更新該列高度,並記錄 item 的 x、y、width、height。

當所有 item 都完成定位後,再回傳整體內容高度。如此一來,UICollectionView 就能正確滾動與顯示。瀑布流布局看似簡單,但關鍵在於「最短列策略」與「布局屬性缓存」。