如何在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
相关产品推荐
相关产品推荐

