iOS应用实现点击屏幕任意区域关闭Tooltip的方案咨询

我之前做iOS项目时也碰到过完全一样的需求，给你分享几个亲测好用的实现方案，你可以根据自己的场景挑：

方案1：全屏透明遮罩层（最简单易上手） #

这个方案的核心是给整个屏幕加一层透明的“点击接收器”，点击它就触发Tooltip关闭逻辑，同时把Tooltip放在遮罩上层，不影响Tooltip自身的交互。

步骤和代码示例：

• 显示Tooltip时，创建一个全屏的UIView作为遮罩，添加到keyWindow或者当前控制器的view最底层
• 给遮罩添加点击手势，触发时关闭Tooltip并移除遮罩
• 如果Tooltip有交互元素（比如按钮），一定要把Tooltip放在遮罩的上层

// 显示Tooltip的方法
func showTooltip() {
    // 创建全屏遮罩
    let overlayView = UIView(frame: UIScreen.main.bounds)
    overlayView.tag = 999 // 标记方便后续移除
    overlayView.backgroundColor = .clear
    overlayView.isUserInteractionEnabled = true
    
    // 添加点击手势
    let tapGesture = UITapGestureRecognizer(target: self, action: #selector(hideTooltip))
    overlayView.addGestureRecognizer(tapGesture)
    
    // 添加到keyWindow（也可以添加到当前VC的view）
    if let keyWindow = UIApplication.shared.keyWindow {
        keyWindow.addSubview(overlayView)
        // 把Tooltip放在遮罩上层
        keyWindow.addSubview(yourTooltipView)
    }
}

@objc private func hideTooltip() {
    // 关闭Tooltip
    yourTooltipView.removeFromSuperview()
    // 移除遮罩层
    if let keyWindow = UIApplication.shared.keyWindow,
       let overlayView = keyWindow.viewWithTag(999) {
        overlayView.removeFromSuperview()
    }
}

方案2：全局触摸事件拦截（适合复杂场景） #

如果你的项目有多个Tooltip或者需要更全局的控制，可以通过拦截UIApplication的触摸事件来实现，这样不管点击屏幕上的任何元素，都能捕获到并关闭Tooltip。

代码示例（用UIApplication分类实现）：

import UIKit

extension UIApplication {
    // 标记是否需要监听关闭Tooltip
    static var shouldCloseTooltip: Bool = false
    // 关闭Tooltip的回调
    static var tooltipCloseHandler: (() -> Void)?
    
    open override func sendEvent(_ event: UIEvent) {
        super.sendEvent(event)
        
        // 只处理触摸结束的事件，避免重复触发
        guard let touches = event.allTouches,
              let touch = touches.first,
              touch.phase == .ended,
              UIApplication.shouldCloseTooltip else {
            return
        }
        
        // 执行关闭逻辑
        UIApplication.tooltipCloseHandler?()
        // 重置状态
        UIApplication.shouldCloseTooltip = false
        UIApplication.tooltipCloseHandler = nil
    }
}

// 使用方式
func showTooltip() {
    // 显示Tooltip
    yourTooltipView.isHidden = false
    
    // 开启全局监听
    UIApplication.shouldCloseTooltip = true
    UIApplication.tooltipCloseHandler = { [weak self] in
        guard let self = self else { return }
        self.yourTooltipView.isHidden = true
    }
}

注意：一定要用weak self避免内存泄漏，而且在Tooltip手动关闭时也要记得重置状态。

方案3：给KeyWindow添加全局点击手势（兼顾灵活与简洁） #

这个方案不需要额外的遮罩层，直接给keyWindow加一个全局点击手势，同时设置cancelsTouchesInView = false，这样其他控件的点击事件依然会正常触发，同时手势也会响应关闭Tooltip。

代码示例：

// 全局手势的引用，方便后续移除
private var globalTapGesture: UITapGestureRecognizer?

func showTooltip() {
    // 显示Tooltip
    yourTooltipView.isHidden = false
    
    // 创建全局点击手势
    globalTapGesture = UITapGestureRecognizer(target: self, action: #selector(hideTooltip))
    // 关键：不拦截其他控件的触摸事件
    globalTapGesture?.cancelsTouchesInView = false
    
    if let keyWindow = UIApplication.shared.keyWindow {
        keyWindow.addGestureRecognizer(globalTapGesture!)
    }
}

@objc private func hideTooltip() {
    // 关闭Tooltip
    yourTooltipView.isHidden = true
    
    // 移除全局手势，避免内存泄漏
    if let gesture = globalTapGesture, let keyWindow = UIApplication.shared.keyWindow {
        keyWindow.removeGestureRecognizer(gesture)
        globalTapGesture = nil
    }
}

这三个方案我都在实际项目中用过：方案1适合简单的单个Tooltip场景，方案3兼顾了灵活性和代码简洁性，方案2适合需要全局统一管理Tooltip的复杂项目。你可以根据自己的需求选最合适的~

内容的提问来源于stack exchange，提问作者Rasesh Gupta