如何将UIRefreshController嵌入UICollectionView的Header中？

刚好我之前也处理过类似的UICollectionView下拉刷新和自定义Header的适配问题，结合你的场景和后来找到的解决方法，整理出完整的实现方案：

问题复盘 #

你当前遇到的核心问题：

• 给带自定义Header的UICollectionView添加UIRefreshControl后，刷新控件默认显示在Header上方
• 由于Toolbar遮挡Header，希望刷新控件能嵌入Header区域内
• 当前下拉需要拉动Header整段高度才会显示刷新控件，存在下拉触发距离过大、刷新控件与CollectionView间距冗余的问题

解决方案：通过contentInset调整刷新控件位置 #

核心思路是利用UICollectionView的contentInset属性，把刷新控件的位置向下偏移Header的高度，让它刚好落在Header区域内，同时减少下拉触发的距离。

修改后的完整代码 #

var refreshControl = UIRefreshControl()
// 统一定义Header高度常量，方便后续修改维护
let headerHeight: CGFloat = 50

override func viewDidLoad() {
    super.viewDidLoad()
    [...]
    refreshControl.tintColor = .gray
    refreshControl.backgroundColor = .white
    refreshControl.addTarget(self, action: #selector(refreshContents), for: .valueChanged)
    eventCollectionView.refreshControl = refreshControl
    
    // 关键设置：让内容整体向下偏移Header高度，刷新控件会随之落在Header区域
    eventCollectionView.contentInset = UIEdgeInsets(top: headerHeight, left: 0, bottom: 0, right: 0)
    // 同步调整滚动指示器的偏移，保持和内容对齐
    eventCollectionView.scrollIndicatorInsets = eventCollectionView.contentInset
    
    eventCollectionView.register(EventHeaderView.self, forSupplementaryViewOfKind: UICollectionView.elementKindSectionHeader, withReuseIdentifier: toolbarId)
}

@objc func refreshContents() {
    self.perform(#selector(finishedRefreshing), with: nil, afterDelay: 1.5)
}

@objc func finishedRefreshing() {
    refreshControl.endRefreshing()
}

func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, referenceSizeForHeaderInSection section: Int) -> CGSize {
    return .init(width: screenWidth, height: headerHeight)
}

原理说明 #

• contentInset.top = headerHeight：让CollectionView的内容整体向下偏移Header高度，刷新控件默认附着在内容顶部，自然就会嵌入到Header区域内
• 同步设置scrollIndicatorInsets：避免滚动指示器和内容位置错位，保证交互体验一致性
• 调整后下拉触发刷新的距离会大幅缩短，同时刷新控件和CollectionView的冗余间距也会消失

效果验证 #

按照Larry Pickles的建议使用contentInset后，已经完美实现预期效果：刷新控件嵌入Header区域内，下拉触发距离更合理，彻底解决了之前的两个问题。

内容的提问来源于stack exchange，提问作者Kühlhausvogel