当前位置：首页 > news >正文

iOS瀑布流布局的实现（swift）

news 来源：原创 2025/5/11 6:04:31

在iOS开发中，瀑布流布局（Waterfall Flow）是一种常见的多列不等高布局方式，适用于图片、商品展示等场景。以下是基于UICollectionView实现瀑布流布局的核心步骤和优化方法：

一、实现原理

瀑布流的核心在于动态计算每个元素的位置，将其放置在当前高度最低的列中。通过自定义UICollectionViewLayout子类，结合数据源的动态高度计算，可实现灵活的布局效果。

二、实现步骤

1. 创建自定义布局类

继承UICollectionViewFlowLayout：需自定义一个类（如WaterfallLayout），继承自UICollectionViewFlowLayout，并重写关键方法。

class WaterfallLayout: UICollectionViewFlowLayout {// 声明属性，如记录每列的最大Y值private var columnHeights: [CGFloat] = []private var attributesArray: [UICollectionViewLayoutAttributes] = []
}

2. 重写`prepareLayout`方法

初始化布局属性：在此方法中计算每个Cell的位置和大小。

override func prepare() {super.prepare()columnHeights = Array(repeating: sectionInset.top, count: numberOfColumns)attributesArray.removeAll()// 遍历所有元素，计算布局属性for item in 0..<collectionView!.numberOfItems(inSection: 0) {let indexPath = IndexPath(item: item, section: 0)guard let attributes = layoutAttributesForItem(at: indexPath) else { continue }attributesArray.append(attributes)}
}

3. 动态计算Cell位置

确定最短列：每次将新Cell插入当前高度最低的列。

func shortestColumnIndex() -> Int {var minIndex = 0for i in 1..<columnHeights.count {if columnHeights[i] < columnHeights[minIndex] {minIndex = i}}return minIndex
}

计算Cell的Frame：根据列数、间距和动态高度确定每个Cell的位置。

let columnIndex = shortestColumnIndex()
let x = sectionInset.left + (itemWidth + minimumInteritemSpacing) * CGFloat(columnIndex)
let y = columnHeights[columnIndex]
let height = delegate?.collectionView(collectionView!, heightForItemAt: indexPath) ?? 100
let frame = CGRect(x: x, y: y, width: itemWidth, height: height)

4. 处理滚动方向和内容尺寸

设置内容尺寸：根据所有列的最大高度确定UICollectionView的内容高度。

override var collectionViewContentSize: CGSize {let maxHeight = columnHeights.max() ?? 0return CGSize(width: collectionView!.bounds.width, height: maxHeight + sectionInset.bottom)
}

三、性能优化

提前计算布局信息
在数据加载阶段预计算所有Cell的高度和位置，避免滚动时重复计算。
图片缓存与异步加载
使用第三方库（如SDWebImage）实现图片的异步加载和缓存，减少内存占用。
Cell重用机制
通过dequeueReusableCell(withReuseIdentifier:for:)重用Cell，避免频繁创建和销毁。
懒加载与分页加载
仅加载可视区域内的Cell，滚动到底部时触发分页加载更多数据。
布局属性缓存
在prepareLayout中缓存所有布局属性，避免频繁调用layoutAttributesForItem。

四、扩展功能示例

1. 动态列数与间距

通过代理方法支持动态调整列数和间距：

protocol WaterfallLayoutDelegate {func numberOfColumns(in collectionView: UICollectionView) -> Intfunc collectionView(_ collectionView: UICollectionView, heightForItemAt indexPath: IndexPath) -> CGFloat
}