垂直滚动UICollectionView时禁用单元格的水平平移手势

这个场景我做列表交互时也碰到过，核心就是要让两个手势（collectionView的垂直滚动和单元格的水平平移）互不干扰，下面给你几个实用的方案：

方案一：利用手势代理判断滚动状态与移动方向 #

这是我最推荐的方法，通过UIGestureRecognizerDelegate的方法，在手势识别前就拦截掉不符合条件的触发。

步骤： #

1. 给单元格的水平平移手势设置代理（可以是单元格本身，也可以是ViewController）
2. 实现gestureRecognizerShouldBegin(_:)方法，做两个关键判断：
   • 先检查collectionView是否正在滚动（拖拽或减速中），如果是，直接不让手势开始识别
   • 再判断触摸的初始移动方向，只有当水平移动幅度大于垂直时，才允许手势触发，避免轻微左右偏移误触发

Swift代码示例： #

// 假设你的自定义单元格是CustomCell，里面的平移手势是cellPanGesture
class CustomCell: UICollectionViewCell, UIGestureRecognizerDelegate {
    var cellPanGesture: UIPanGestureRecognizer!
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        setupGesture()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupGesture()
    }
    
    private func setupGesture() {
        cellPanGesture = UIPanGestureRecognizer(target: self, action: #selector(handlePan(_:)))
        cellPanGesture.delegate = self
        addGestureRecognizer(cellPanGesture)
    }
    
    @objc private func handlePan(_ gesture: UIPanGestureRecognizer) {
        // 这里写你的单元格平移逻辑
    }
    
    // 核心代理方法
    func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
        // 找到当前所在的collectionView（可通过父视图链获取，或者提前传入）
        guard let collectionView = superview as? UICollectionView else { return true }
        
        // 如果collectionView正在滚动，直接禁用手势触发
        if collectionView.isDragging || collectionView.isDecelerating {
            return false
        }
        
        // 判断初始移动方向，优先响应垂直滚动
        guard let panGesture = gestureRecognizer as? UIPanGestureRecognizer else { return true }
        let translation = panGesture.translation(in: collectionView)
        // 只有水平移动幅度大于垂直时，才允许手势触发
        return abs(translation.x) > abs(translation.y)
    }
}

方案二：监听CollectionView滚动状态，动态启用/禁用手势 #

通过监听UIScrollView的滚动回调，在滚动开始时禁用所有可见单元格的水平手势，滚动结束后再重新启用。

Swift代码示例： #

class YourViewController: UIViewController, UICollectionViewDelegate, UICollectionViewDataSource {
    @IBOutlet weak var collectionView: UICollectionView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        collectionView.delegate = self
        collectionView.dataSource = self
    }
    
    // 滚动开始时禁用手势
    func scrollViewWillBeginDragging(_ scrollView: UIScrollView) {
        disableCellPanGestures()
    }
    
    // 拖拽结束且不减速时，启用手势
    func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
        if !decelerate {
            enableCellPanGestures()
        }
    }
    
    // 减速结束时启用手势
    func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
        enableCellPanGestures()
    }
    
    // 工具方法：禁用可见单元格的手势
    private func disableCellPanGestures() {
        collectionView.visibleCells.forEach { cell in
            guard let customCell = cell as? CustomCell else { return }
            customCell.cellPanGesture.isEnabled = false
        }
    }
    
    // 工具方法：启用可见单元格的手势
    private func enableCellPanGestures() {
        collectionView.visibleCells.forEach { cell in
            guard let customCell = cell as? CustomCell else { return }
            customCell.cellPanGesture.isEnabled = true
        }
    }
    
    // 注意：单元格复用时要重置手势状态
    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        let cell = collectionView.dequeueReusableCell(withReuseIdentifier: "CustomCell", for: indexPath) as! CustomCell
        // 重置手势状态，避免复用后手势保持禁用状态
        cell.cellPanGesture.isEnabled = true
        return cell
    }
}

方案对比 #

• 方案一：更优雅，不需要遍历单元格，通过手势代理从源头拦截，同时处理了方向判断，误触发概率更低。
• 方案二：逻辑更直观，但需要注意单元格复用的情况，必须在cellForItemAt里重置手势状态，否则滚动后复用的单元格手势可能还是禁用的。

之前你尝试禁用UICollectionView的滚动是走反了方向，应该控制的是单元格的手势，而不是列表的滚动能力，上面的方案应该能完美解决你的问题。

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