如何通过代码控制UICollectionViewCell移动并取消手动拖拽？

我之前也碰到过类似的“双重拖拽”困扰，给你分享几个实用的方案，完美解决你的需求：

一、取消手动拖拽的可见效果，实现固定步长滚动 #

核心思路是拦截滚动结束前的目标偏移，直接替换为你设定的固定偏移量，系统会自动按照你指定的位置滚动，不会出现用户拖拽的中间状态。

因为UICollectionView继承自UIScrollView，我们可以利用UIScrollView的代理方法scrollViewWillEndDragging(_:withVelocity:targetContentOffset:)来实现：

代码示例（Swift） #

extension YourViewController: UIScrollViewDelegate {
    func scrollViewWillEndDragging(_ scrollView: UIScrollView, withVelocity velocity: CGPoint, targetContentOffset: UnsafeMutablePointer<CGPoint>) {
        guard let collectionView = scrollView as? UICollectionView,
              let flowLayout = collectionView.collectionViewLayout as? UICollectionViewFlowLayout else {
            return
        }
        
        // 计算单页宽度（item宽度 + 行间距，根据你的布局调整）
        let pageWidth = flowLayout.itemSize.width + flowLayout.minimumLineSpacing
        // 加上左内边距（如果有设置的话）
        let contentInsetLeft = collectionView.contentInset.left
        
        // 计算当前所在的近似页面索引
        let currentOffsetX = scrollView.contentOffset.x - contentInsetLeft
        var targetPage = Int(currentOffsetX / pageWidth)
        
        // 根据滑动速度判断用户意图：速度为正滑到下一页，负则上一页（加小阈值避免误触）
        if velocity.x > 0.1 {
            targetPage += 1
        } else if velocity.x < -0.1 {
            targetPage -= 1
        }
        
        // 确保页面索引在合法范围内（0到总item数-1）
        targetPage = max(0, min(targetPage, collectionView.numberOfItems(inSection: 0) - 1))
        
        // 直接修改系统的目标偏移，系统会自动滚动到这里
        targetContentOffset.pointee.x = CGFloat(targetPage) * pageWidth + contentInsetLeft
    }
}

为什么这个方法能避免“双重拖拽”？ #

这个方法是在系统即将计算最终滚动位置时被调用的，你直接修改了targetContentOffset的指针值，系统会完全按照你设定的偏移来滚动，不会执行用户拖拽产生的中间偏移，自然就不会出现“先手动移动、再代码修正”的现象。

二、直接移动到特定偏移位置 #

如果你需要主动触发滚动到某个自定义偏移（而非通过用户拖拽），可以用下面两种方式：

1. 滚动到自定义偏移 #

直接调用setContentOffset方法，适合你需要精确控制到某个像素位置的场景：

// 示例：滚动到x偏移为300的位置（横向滚动y保持0即可）
let customOffset = CGPoint(x: 300, y: 0)
// 记得加上内边距（如果有设置）
let finalOffset = CGPoint(x: customOffset.x + yourCollectionView.contentInset.left, y: customOffset.y)
yourCollectionView.setContentOffset(finalOffset, animated: true)

2. 滚动到指定索引的cell #

如果目标是某个具体的item，用scrollToItem更方便，系统会自动计算对应的偏移：

let targetIndexPath = IndexPath(item: 3, section: 0)
// .centeredHorizontally 可以改为你需要的滚动位置（比如.left、.right）
yourCollectionView.scrollToItem(at: targetIndexPath, at: .centeredHorizontally, animated: true)

额外注意事项 #

• 如果你的UICollectionView用了自定义布局（非UICollectionViewFlowLayout），需要自己计算每个页面的宽度/高度，替换示例中的pageWidth逻辑。
• 若要完全禁止用户手动拖拽（仅通过代码控制滚动），可以直接设置yourCollectionView.isScrollEnabled = false，但这不符合你“用户滑动触发”的需求，所以前面的代理方法更适合。

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