UIScrollView缩放后单指触摸改为平移的实现问题

哥们，这个坑我之前踩过！直接修改UIScrollView自带的panGestureRecognizer触摸数限制根本没用，因为系统内部会在缩放状态切换、手势生命周期等关键时机偷偷重置这些属性，导致你的设置被覆盖。给你两个亲测有效的解决方案：

方案一：利用手势代理控制系统Pan手势的行为 #

这个方案不用额外添加手势，只通过代理规则让系统的Pan手势在缩放状态下支持单指平移：

1. 让你的视图控制器遵循UIGestureRecognizerDelegate协议
2. 在视图初始化时（比如viewDidLoad）设置Pan手势的代理：

   override func viewDidLoad() {
       super.viewDidLoad()
       // ... 其他初始化代码
       scrollView.panGestureRecognizer.delegate = self
   }
   

3. 实现代理方法，动态调整手势的触摸数和生效条件：

   func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
       guard let panGesture = gestureRecognizer as? UIPanGestureRecognizer, panGesture == scrollView.panGestureRecognizer else {
           return true
       }
   
       let currentScale = scrollView.zoomScale
       if currentScale != 1.0 {
           // 缩放状态下，允许单指触发Pan手势
           panGesture.minimumNumberOfTouches = 1
           panGesture.maximumNumberOfTouches = 1
       } else {
           // 非缩放状态，恢复默认的单指滚动行为
           panGesture.minimumNumberOfTouches = 1
           panGesture.maximumNumberOfTouches = 1
           // 如果你想回到原来双指平移的逻辑，这里可以设为2，但通常默认是单指滚动
       }
       return true
   }
   
   // 确保Pan手势和缩放手势可以同时生效
   func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
       return otherGestureRecognizer is UIPinchGestureRecognizer
   }
   

方案二：添加自定义单指Pan手势（更灵活可控） #

如果方案一的系统手势行为不符合预期，可以自己添加一个单指Pan手势，完全掌控平移逻辑：

1. 初始化自定义手势并添加到ScrollView：

   private var singleFingerPan: UIPanGestureRecognizer!
   
   override func viewDidLoad() {
       super.viewDidLoad()
       // ... 其他初始化代码
       
       singleFingerPan = UIPanGestureRecognizer(target: self, action: #selector(handleSingleFingerPan(_:)))
       singleFingerPan.minimumNumberOfTouches = 1
       singleFingerPan.maximumNumberOfTouches = 1
       singleFingerPan.delegate = self
       scrollView.addGestureRecognizer(singleFingerPan)
   }
   

2. 实现代理方法，让自定义手势只在缩放状态下生效：

   func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
       if gestureRecognizer == singleFingerPan {
           // 仅当缩放比例不为1时，允许自定义手势触发
           return scrollView.zoomScale != 1.0
       }
       return true
   }
   
   func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
       // 允许自定义手势和系统缩放手势共存
       return otherGestureRecognizer is UIPinchGestureRecognizer
   }
   

3. 实现手势回调，手动处理内容平移：

   @objc private func handleSingleFingerPan(_ gesture: UIPanGestureRecognizer) {
       let translation = gesture.translation(in: scrollView)
       
       // 计算新的内容偏移量，这里可以根据需求调整逻辑
       var newOffset = scrollView.contentOffset
       newOffset.x -= translation.x
       newOffset.y -= translation.y
       
       scrollView.contentOffset = newOffset
       
       // 重置手势的平移量，避免每次回调累加
       gesture.setTranslation(.zero, in: scrollView)
   }
   

为什么你原来的方法不生效？ #

UIScrollView的内部手势系统有自己的状态管理逻辑，在缩放开始、结束或者手势状态变化时，会自动重置panGestureRecognizer的触摸数限制，你在scrollViewDidZoom里的设置会被系统覆盖，所以看不到效果。

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