在 iOS 应用中使用 UIPanGestureRecognizer 实现顺畅的手势滑动，并解决与其他手势的冲突

2023-12-12 00:26:15

在 iOS 应用中实现顺畅的手势滑动：解决 UIPanGestureRecognizer 与其他手势的冲突

在当今快速发展的移动应用领域中，提供无缝流畅的用户体验至关重要。手势识别在实现这种体验方面发挥着至关重要的作用，而 UIPanGestureRecognizer 尤其强大，可用于实现平滑滑动、直观拖放和缩放手势。然而，在复杂的界面中，涉及多个手势时，可能会发生手势冲突，导致意外行为和不佳的用户体验。

了解 UIPanGestureRecognizer

UIPanGestureRecognizer 是一种手势识别器，专门用于检测和响应用户在触摸屏上的手指或触控笔平移动作。它提供了广泛的属性和方法，使开发者能够根据其应用程序的特定需求定制手势行为。以下是一些关键属性：

minimumNumberOfTouches： 触发手势所需的最低手指数量。
maximumNumberOfTouches： 参与手势的最大手指数量。
allowedPressTypes： 允许的按压类型，例如轻按或长按。
translationInView： 返回手势相对于指定视图的平移量。

解决手势冲突

当涉及多个手势识别器时，可能会发生手势冲突。例如，在包含 UITableView 的视图控制器中，用户在 UITableView 上滑动时，UIPanGestureRecognizer 也可能会触发。为了解决此问题，开发者可以采用以下技术：

设置优先级： 使用 setDelaysTouchesBegan(_:for:) 和 setDelaysTouchesEnded(_:for:) 方法，开发者可以设置手势识别器的优先级。具有较高优先级的识别器将优先处理触摸事件。
禁用冲突手势： 在某些情况下，可以暂时禁用冲突手势。例如，当 UIPanGestureRecognizer 处于活动状态时，可以通过将 UITableView 的 scrollEnabled 属性设置为 false 来禁用 UITableView 的滑动。
使用手势识别器代理： UIPanGestureRecognizer 代理方法（例如 gestureRecognizerShouldBegin(_:) 和 gestureRecognizer:shouldReceiveTouch:）可用于过滤手势识别并防止冲突。

代码示例

以下示例演示了如何在 UITableView 中解决与 UIPanGestureRecognizer 的手势冲突：

class ViewController: UIViewController, UIGestureRecognizerDelegate {

    var panGestureRecognizer: UIPanGestureRecognizer!
    var tableView: UITableView!

    override func viewDidLoad() {
        super.viewDidLoad()

        tableView = UITableView(frame: view.bounds)
        view.addSubview(tableView)

        panGestureRecognizer = UIPanGestureRecognizer(target: self, action: #selector(handlePanGesture))
        panGestureRecognizer.delegate = self
        panGestureRecognizer.minimumNumberOfTouches = 1
        view.addGestureRecognizer(panGestureRecognizer)
    }

    @objc func handlePanGesture(_ gestureRecognizer: UIPanGestureRecognizer) {
        if gestureRecognizer.state == .began {
            tableView.isScrollEnabled = false
        } else if gestureRecognizer.state == .ended {
            tableView.isScrollEnabled = true
        }
    }

    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldReceive touch: UITouch) -> Bool {
        if gestureRecognizer == panGestureRecognizer && tableView.isScrollEnabled {
            let location = touch.location(in: tableView)
            return !tableView.indexPathForRow(at: location).isEmpty
        }
        return true
    }
}