Swift中如何为同一元素的同一手势配置多个识别器并解决冲突

Hey there! I’ve run into this exact gesture recognizer conflict before, so let’s break down what’s happening and how to fix it.

The Root Problem #

By default, when a UIGestureRecognizer successfully identifies a gesture, it blocks other recognizers (or even UIControl touch events like button taps) from handling the same touch sequence. That’s why your existing tap behavior stops working once you add the extension’s tap recognizer—they’re competing for the same input.

Solutions by Scenario #

Scenario 1: Your Existing Tap is Another UIGestureRecognizer

To let both tap recognizers fire, you need to enable simultaneous recognition using the UIGestureRecognizerDelegate protocol. Here’s how to integrate this into your UIView extension:

First, update your extension to assign a delegate and tag to your gesture (the tag helps distinguish your extension’s gestures from others):

import UIKit

extension UIView {
    func addTrackingGestures() {
        // Tap Gesture Setup
        let tapGesture = UITapGestureRecognizer(target: self, action: #selector(handleTrackingTap))
        tapGesture.delegate = self
        tapGesture.tag = 999 // Mark this as our extension's gesture
        addGestureRecognizer(tapGesture)
        
        // Swipe Gesture Setup
        let swipeGesture = UISwipeGestureRecognizer(target: self, action: #selector(handleTrackingSwipe))
        swipeGesture.delegate = self
        addGestureRecognizer(swipeGesture)
    }
    
    @objc private func handleTrackingTap() {
        print("Extension tap triggered!")
    }
    
    @objc private func handleTrackingSwipe() {
        print("Extension swipe triggered!")
    }
}

Then, add a delegate extension to allow simultaneous recognition for tap gestures:

extension UIView: UIGestureRecognizerDelegate {
    public func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        // Only allow simultaneous recognition for our extension's tap and other taps
        return gestureRecognizer.tag == 999 
            && gestureRecognizer is UITapGestureRecognizer 
            && otherGestureRecognizer is UITapGestureRecognizer
    }
    
    // Optional: Set priority if you want one tap to fire before the other
    public func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRequireFailureOf otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        // Make our extension's tap wait for the existing tap to fail first
        return gestureRecognizer.tag == 999 
            && gestureRecognizer is UITapGestureRecognizer 
            && otherGestureRecognizer is UITapGestureRecognizer
    }
}

Scenario 2: Your Existing Tap is a UIControl Event (e.g., UIButton Tap)

If the element is a UIButton (or any UIControl), the issue is that your gesture recognizer is blocking the control’s native touch handling. Fix this by setting cancelsTouchesInView to false on your extension’s tap gesture:

// Add this line when creating your tap gesture
tapGesture.cancelsTouchesInView = false

This ensures the gesture recognizes the tap without canceling the touch events that trigger the button’s native UIControl actions.

Key Notes #

• Use the tag to avoid unintended conflicts with other gestures (like swipes) on the same view.
• Adjust the delegate methods based on your exact needs—you might want to restrict simultaneous recognition only to specific gesture types.

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