iOS 13可拖动模态框与UICollectionView滚动冲突问题求解

我之前也碰到过类似的头疼问题——非全屏模态的拖动关闭手势和内部滚动视图的交互冲突，确实很影响用户体验。针对你的月历场景，核心思路就是让系统的模态拖动手势只在CollectionView无法滚动时才生效，下面分享两个优雅的解决方案：

方案一：手势识别器代理协调优先级（推荐） #

通过手势代理判断手势触发时机，只在CollectionView完全无法滚动时，才让系统的拖动关闭手势响应：

1. 先在模态控制器中获取系统的拖动手势并设置代理：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // 获取iOS13+默认Sheet模态的拖动手势
    if let sheetPresentation = presentationController as? UISheetPresentationController {
        sheetPresentation.panGestureRecognizer.delegate = self
    }
}

2. 实现UIGestureRecognizerDelegate方法，根据CollectionView状态判断是否允许系统手势启动：

extension YourModalViewController: UIGestureRecognizerDelegate {
    func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
        guard let collectionView = self.collectionView else { return true }
        
        // 判定CollectionView是否处于顶部（考虑contentInset的情况）
        let isAtTop = collectionView.contentOffset.y <= -collectionView.contentInset.top
        // 判定CollectionView是否还有可滚动的内容（能否向上滚动查看后续月份）
        let hasScrollableContent = collectionView.contentSize.height > 
            collectionView.bounds.height + 
            collectionView.contentInset.top + 
            collectionView.contentInset.bottom
        
        // 只有当CollectionView在顶部且没有更多可滚动内容时，才允许系统拖动手势触发
        // 其余情况都让CollectionView处理滚动手势
        return isAtTop && !hasScrollableContent
    }
}

这个方法只在手势启动时做一次判断，性能开销极小，逻辑也清晰易懂。

方案二：动态启用/禁用系统拖动手势 #

如果你觉得代理方式有点绕，也可以通过监听CollectionView的滚动位置，动态控制系统手势的启用状态：

1. 在控制器viewDidLoad中添加KVO监听：

private var contentOffsetObserver: NSKeyValueObservation?

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 监听CollectionView的滚动位置变化
    contentOffsetObserver = collectionView.observe(\.contentOffset) { [weak self] _, _ in
        guard let self = self,
              let sheetPresentation = self.presentationController as? UISheetPresentationController else {
            return
        }
        
        let collectionView = self.collectionView
        let isAtTop = collectionView.contentOffset.y <= -collectionView.contentInset.top
        let hasScrollableContent = collectionView.contentSize.height > 
            collectionView.bounds.height + 
            collectionView.contentInset.top + 
            collectionView.contentInset.bottom
        
        // 仅当CollectionView在顶部且无更多内容时，启用系统拖动关闭手势
        sheetPresentation.panGestureRecognizer.isEnabled = isAtTop && !hasScrollableContent
    }
}

// 记得在控制器销毁时移除监听，避免内存泄漏
deinit {
    contentOffsetObserver?.invalidate()
}

这个方法逻辑更直观，但会随着CollectionView滚动频繁触发回调，性能上略逊于代理方案，但日常使用完全没问题。

为什么之前的方案没生效？ #

你提到的“禁用内部UIPanGestureRecognizer找不到presentedView”，是因为系统的拖动手势属于UISheetPresentationController而非presentedView本身；“设置CollectionView手势代理阻止系统手势不可行”，大概率是没有正确判断滚动状态和手势优先级。上面的两种方案都是直接针对系统手势的触发逻辑做控制，能从根源解决冲突。

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