如何在横向UICollectionView中实现右滑触发的Refresh Control刷新功能

该功能完全可以实现，你现有的实现思路核心逻辑正确，只需要补全边界判断、交互场景覆盖和状态管控即可正常运行，无需依赖第三方组件。

现有代码存在的问题 #

• 未判断当前是否处于第一个cell的位置，滑动到后续cell时右滑也会误触发刷新
• 仅监听了scrollViewDidEndDecelerating回调，未覆盖用户拖拽松手无惯性滚动的场景，会出现触发不灵敏的问题
• 未增加刷新状态锁，可能出现重复触发刷新的问题
• 无刷新状态视觉提示，用户无法感知当前刷新进度

优化后的完整实现代码 #

前置属性声明 #

/// 刷新状态锁，避免重复触发
private var isRefreshing = false
/// 触发刷新的偏移阈值，可根据需求调整
private let refreshTriggerOffset: CGFloat = -80
/// 刷新指示器，可替换为自定义动画视图
private let refreshIndicator = UIActivityIndicatorView(style: .medium)

初始化配置 #

override func viewDidLoad() {
    super.viewDidLoad()
    // 配置刷新指示器，放置在collectionView左外侧
    refreshIndicator.frame = CGRect(x: -45, y: collectionView.bounds.midY - 15, width: 30, height: 30)
    collectionView.addSubview(refreshIndicator)
    // 确认collectionView开启分页效果（cell占满全屏需要）
    collectionView.isPagingEnabled = true
}

ScrollView代理方法优化 #

override func scrollViewDidScroll(_ scrollView: UIScrollView) {
    // 非刷新状态下才处理滑动逻辑
    guard !isRefreshing else { return }
    // 仅在第一个cell位置（x偏移<=0）处理刷新逻辑
    guard scrollView.contentOffset.x <= 0 else { return }
    
    let pullOffset = scrollView.contentOffset.x
    // 根据拖拽距离更新指示器动画状态
    if pullOffset < refreshTriggerOffset {
        refreshIndicator.startAnimating()
    } else {
        refreshIndicator.stopAnimating()
    }
}

override func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
    guard !isRefreshing, scrollView.contentOffset.x <= 0 else { return }
    // 拖拽偏移达到阈值触发刷新
    if scrollView.contentOffset.x < refreshTriggerOffset {
        startRefresh()
    }
}

override func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
    guard !isRefreshing, scrollView.contentOffset.x <= 0 else { return }
    if scrollView.contentOffset.x < refreshTriggerOffset {
        startRefresh()
    }
}

刷新逻辑实现 #

private func startRefresh() {
    isRefreshing = true
    // 调整左内边距，露出刷新指示器
    collectionView.contentInset.left = 40
    // 执行你的刷新逻辑，比如网络请求
    fetchNewData { [weak self] in
        guard let self = self else { return }
        // 刷新完成后重置状态
        self.collectionView.reloadData()
        self.collectionView.contentInset.left = 0
        self.refreshIndicator.stopAnimating()
        self.isRefreshing = false
    }
}

// 模拟刷新请求方法，替换为你自己的业务逻辑
private func fetchNewData(completion: @escaping () -> Void) {
    print("RELOADING")
    DispatchQueue.main.asyncAfter(deadline: .now() + 1.5, execute: completion)
}

注意事项 #

• 如果你的cell存在左右内边距，可根据实际视觉效果调整refreshTriggerOffset的数值
• 刷新状态锁isRefreshing必须保留，避免刷新过程中用户滑动重复触发请求
• 可将系统UIActivityIndicatorView替换为自定义动效视图，适配横向滑动的交互视觉

内容的提问来源于stack exchange，提问作者tHatpart