You need to enable JavaScript to run this app. 如何在viewController的多个sub-views上检测触摸事件?
优惠活动
大模型
产品
解决方案
定价
更多

如何在viewController的多个sub-views上检测触摸事件?

棋盘方块点击响应的可行实现方案

首先澄清一个很多开发者踩过的认知坑:你之前实现失败的核心原因,大概率是复用了同一个UITapGestureRecognizer实例挂载到了多个方块视图上——苹果文档提到的“UITapGestureRecognizer一次仅能应用于单个视图”,指的是单个手势实例不能被绑定到多个视图(给第二个视图添加该手势时,系统会自动解绑它和第一个视图的关联),并不是说不能给每个方块单独创建手势实例使用。

针对你的国际象棋棋盘类规则网格场景,有三个经过验证的可落地方案,按适配性从高到低排列:

方案1:为每个方块绑定独立的手势识别器

这是最直接的实现方式,完全符合手势系统的设计逻辑:

  • 循环创建每个方块视图时,单独初始化一个UITapGestureRecognizer实例,绝对不要复用同一个对象
  • 通过视图的tag或者关联存储,给每个方块标记对应的行列坐标,方便点击时快速定位
// 棋盘方块创建示例
for row in 0..<8 {
    for col in 0..<8 {
        let square = UIView()
        // 单独为每个方块生成手势,禁止复用
        let tap = UITapGestureRecognizer(target: self, action: #selector(squareTapped(_:)))
        square.addGestureRecognizer(tap)
        // 标记方块的位置,避免写额外的关联对象
        square.tag = row * 8 + col
        view.addSubview(square)
    }
}

@objc private func squareTapped(_ gesture: UITapGestureRecognizer) {
    // 直接取触发手势的方块
    guard let targetSquare = gesture.view else { return }
    // 执行自定义操作,比如修改背景色
    targetSquare.backgroundColor = .systemRed
    // 从tag解算坐标做业务逻辑
    let row = targetSquare.tag / 8
    let col = targetSquare.tag % 8
}

必须注意的踩坑点:

  • 确保方块视图的isUserInteractionEnabled属性为true,部分自定义视图可能默认关闭交互,会导致手势完全不触发
  • 不要把父视图的手势直接透传给子视图,避免出现触摸冲突

方案2:在棋盘父视图统一处理触摸(性能最优)

对于国际象棋这类固定网格的规则布局,完全不需要给每个方块绑手势,只需要在承载所有方块的父棋盘视图上加1个手势,通过坐标计算命中的方块即可:

  • 整个棋盘只绑定1个UITapGestureRecognizer,完全符合苹果文档的单视图绑定要求
  • 点击触发时,把触摸点的坐标转换到对应视图的坐标系,直接通过网格尺寸计算命中的方块位置,连遍历都不需要
// 父棋盘视图只添加一次手势
let boardTap = UITapGestureRecognizer(target: self, action: #selector(boardTapped(_:)))
boardContainerView.addGestureRecognizer(boardTap)

@objc private func boardTapped(_ gesture: UITapGestureRecognizer) {
    // 取触摸点在父棋盘上的坐标
    let touchPoint = gesture.location(in: boardContainerView)
    // 网格布局可直接通过坐标计算行列,无遍历开销
    let squareSize = boardContainerView.bounds.width / 8
    let row = Int(touchPoint.y / squareSize)
    let col = Int(touchPoint.x / squareSize)
    // 从预存的方块字典里取出目标方块
    if let targetSquare = squareMap["\(row)-\(col)"] {
        targetSquare.backgroundColor = .systemBlue
    }
}

这个方案的优势是完全规避了手势复用的问题,对于8x8甚至更大尺寸的棋盘,性能开销可以忽略,也不会出现子视图交互穿透的问题。

方案3:在自定义方块类中直接处理触摸事件

如果你的方块是自定义的UIView子类,甚至可以不依赖手势系统,直接重写触摸响应方法实现点击逻辑,还可以自定义按下、抬起的交互动画:

class ChessSquareView: UIView {
    // 触摸抬起时触发点击逻辑
    override func touchesEnded(_ touches: Set<UITouch>, with event: UIEvent?) {
        super.touchesEnded(touches, with: event)
        // 直接修改自身样式
        self.backgroundColor = .systemGreen
        // 通过闭包把事件抛给视图控制器处理业务
        didTapCallback?()
    }
}

这个方案适合需要自定义触摸反馈的场景,比如按下时方块轻微缩放的动效,灵活性最高。


内容的提问来源于stack exchange,提问作者MRoot

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 17:24:02