Swift iOS：如何将UIView的手势交互传递给下方的UITableView

嘿，我来帮你搞定这个手势传递的问题！你之前的代码之所以会移除UITableView的手势，是因为当你把一个手势识别器从一个视图添加到另一个视图时，系统默认会将它从原视图上移除——这就是为什么你的tableView自己没法滚动了。下面给你两种靠谱的解决思路，都不用把UIView设为tableView表头：

方案一：自定义手势联动，手动驱动tableView滚动 #

给顶部UIView添加一个独立的拖拽手势，然后通过手势回调来控制tableView的滚动，同时允许两个手势同时识别，避免冲突。

实现步骤&代码： #

1. 给顶部UIView添加UIPanGestureRecognizer并设置代理
2. 实现代理方法允许手势同时识别
3. 在手势回调中计算偏移量，更新tableView的contentOffset

class ViewController: UIViewController, UIGestureRecognizerDelegate {
    let topView = UIView()
    let tableView = UITableView()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupLayout()
        
        // 添加顶部视图的拖拽手势
        let panGesture = UIPanGestureRecognizer(target: self, action: #selector(handleTopViewPan(_:)))
        panGesture.delegate = self
        topView.addGestureRecognizer(panGesture)
        
        // 确保tableView自身滚动功能正常
        tableView.isScrollEnabled = true
        tableView.register(UITableViewCell.self, forCellReuseIdentifier: "Cell")
        tableView.dataSource = self
    }
    
    // 布局顶部视图和tableView
    private func setupLayout() {
        topView.translatesAutoresizingMaskIntoConstraints = false
        tableView.translatesAutoresizingMaskIntoConstraints = false
        
        view.addSubview(topView)
        view.addSubview(tableView)
        
        NSLayoutConstraint.activate([
            topView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
            topView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            topView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            topView.heightAnchor.constraint(equalToConstant: 100),
            
            tableView.topAnchor.constraint(equalTo: topView.bottomAnchor),
            tableView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            tableView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            tableView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)
        ])
        
        topView.backgroundColor = .lightGray
    }
    
    // 处理顶部视图的拖拽手势
    @objc private func handleTopViewPan(_ gesture: UIPanGestureRecognizer) {
        let translation = gesture.translation(in: view)
        // 计算tableView需要滚动的偏移量（反向抵消拖拽的Y轴位移）
        let newOffset = CGPoint(x: tableView.contentOffset.x, y: tableView.contentOffset.y - translation.y)
        // 更新tableView滚动位置，同时重置手势位移避免累积
        tableView.setContentOffset(newOffset, animated: false)
        gesture.setTranslation(.zero, in: view)
    }
    
    // 允许顶部视图的手势与tableView的手势同时识别
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        // 仅和tableView的拖拽手势联动
        return otherGestureRecognizer.view == tableView && otherGestureRecognizer is UIPanGestureRecognizer
    }
}

// UITableView数据源实现
extension ViewController: UITableViewDataSource {
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return 50
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
        cell.textLabel?.text = "Row \(indexPath.row + 1)"
        return cell
    }
}

方案二：重写UIView的hitTest，直接传递触摸事件给tableView #

这种方法更接近原生体验——让顶部UIView把触摸事件“透传”给下方的tableView，这样tableView自己的滚动手势就能直接响应，不需要手动处理滚动逻辑。

实现步骤&代码： #

1. 创建一个自定义UIView子类，重写hitTest(_:with:)方法
2. 在自定义视图中指定要传递事件的目标view（即你的tableView）

// 自定义透传视图
class PassthroughView: UIView {
    weak var targetScrollView: UIScrollView? // UITableView继承自UIScrollView
    
    override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
        let hitView = super.hitTest(point, with: event)
        
        // 如果触摸的是视图本身（而非子控件），就把事件传递给目标scrollView
        if hitView == self {
            let convertedPoint = convert(point, to: targetScrollView)
            return targetScrollView?.hitTest(convertedPoint, with: event)
        }
        
        // 如果触摸的是子控件（比如按钮），让子控件自己处理事件
        return hitView
    }
}

然后在ViewController中使用这个自定义视图：

class ViewController: UIViewController {
    let topView = PassthroughView()
    let tableView = UITableView()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupLayout()
        
        // 设置目标scrollView为tableView
        topView.targetScrollView = tableView
        
        tableView.isScrollEnabled = true
        tableView.register(UITableViewCell.self, forCellReuseIdentifier: "Cell")
        tableView.dataSource = self
    }
    
    // 布局代码和方案一一致
    private func setupLayout() {
        // ... 同方案一的布局代码
    }
}

// UITableView数据源扩展同方案一

方案对比 #

• 方案一适合需要自定义滚动逻辑的场景，但需要自己处理滚动边界、反弹等原生效果，代码量稍多
• 方案二更推荐，完全复用tableView的原生滚动逻辑，体验更自然，而且不影响顶部视图上的子控件交互

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