如何在用户滚动时禁用UICollectionView的自动滚动功能？

这个问题我在做横向轮播组件时也碰到过，核心逻辑就是在用户和CollectionView交互期间暂停自动滚动，交互完全结束后再恢复自动滚动。下面是具体的实现步骤和代码示例：

核心思路 #

通过监听UIScrollView的代理方法（UICollectionView继承自UIScrollView），捕捉用户的拖拽、减速等行为，动态启停自动滚动的Timer：

• 用户开始拖拽时：停止自动滚动Timer
• 用户拖拽结束且无减速：立即重启Timer
• 用户拖拽结束后仍在减速：等滚动完全停止后重启Timer

具体代码实现 #

1. 声明Timer及相关变量 #

首先在ViewController中定义Timer实例和自动滚动的时间间隔：

class YourCollectionVC: UIViewController, UICollectionViewDelegate {
    @IBOutlet weak var collectionView: UICollectionView!
    // 自动滚动Timer
    private var autoScrollTimer: Timer?
    // 自动滚动间隔（3秒）
    private let autoScrollInterval: TimeInterval = 3.0
    
    // ... 其他初始化、数据源代码
}

2. 封装Timer的启停方法 #

把启动和停止Timer的逻辑抽成独立方法，避免重复代码：

private func startAutoScrollTimer() {
    // 先停止已有Timer，防止重复创建
    stopAutoScrollTimer()
    autoScrollTimer = Timer.scheduledTimer(withTimeInterval: autoScrollInterval, repeats: true) { [weak self] _ in
        self?.scrollToNextItem()
    }
}

private func stopAutoScrollTimer() {
    autoScrollTimer?.invalidate()
    autoScrollTimer = nil
}

// 滚动到下一个单元格的逻辑
private func scrollToNextItem() {
    guard let collectionView = collectionView else { return }
    let totalItems = collectionView.numberOfItems(inSection: 0)
    guard totalItems > 0 else { return }
    
    // 获取当前可见的第一个单元格索引
    let currentIndex = collectionView.indexPathsForVisibleItems.first?.item ?? 0
    // 计算下一个索引，超出总数则回到第一个（实现循环滚动）
    let nextIndex = (currentIndex + 1) % totalItems
    let targetIndexPath = IndexPath(item: nextIndex, section: 0)
    
    // 平滑滚动到目标单元格
    collectionView.scrollToItem(at: targetIndexPath, at: .centeredHorizontally, animated: true)
}

3. 实现UIScrollView代理方法 #

通过代理方法监听用户的滚动行为，动态控制Timer：

func scrollViewWillBeginDragging(_ scrollView: UIScrollView) {
    // 用户开始拖拽，立即停止自动滚动
    stopAutoScrollTimer()
}

func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
    if !decelerate {
        // 如果拖拽后没有减速（用户直接停住），立刻恢复自动滚动
        startAutoScrollTimer()
    }
}

func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
    // 滚动减速完全停止后，恢复自动滚动
    startAutoScrollTimer()
}

4. 处理页面生命周期 #

在页面显示时启动Timer，消失时停止，避免内存泄漏：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    startAutoScrollTimer()
}

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    stopAutoScrollTimer()
}

注意事项 #

• 一定要在Timer的闭包中使用[weak self]，避免循环引用导致内存泄漏
• 如果不需要循环滚动，可以去掉(currentIndex + 1) % totalItems的取模逻辑，改成判断是否超出总数后停止
• 确保CollectionView的delegate已经设置为当前ViewController（可以在Storyboard中关联，或者代码里设置collectionView.delegate = self）

这样实现后，用户手动滚动时自动滚动会立刻暂停，当用户松手且滚动完全停止后，自动滚动会继续生效，完美解决冲突问题。

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