如何在SwiftUI中检测按下按钮时键盘是否存在

之前尝试方案失效的核心原因 #

• 多数通用实现依赖系统级的视图高度变化、键盘弹起/隐藏通知来维护一个全局的键盘状态标记，这类回调存在100~300ms的异步延迟，按钮点击事件触发的瞬间，这个全局标记还没同步到最新状态，自然判断不准
• 部分方案用输入框是否持有焦点反推键盘弹出状态，遇到第三方输入法弹层、外接键盘激活、焦点临时转移的场景会出现判定错误
• 直接读取系统提供的键盘可见性静态属性时，部分系统版本会存在缓存值和实际状态不一致的问题

按钮触发时刻的准确判断方案 #

跨平台通用逻辑 #

• 核心思路放弃依赖异步更新的全局状态标记，改为在按钮点击回调触发的第一时间，同步计算当前页面的实时布局差值做判断
• 计算方式：对比当前应用窗口的实际可见内容高度和屏幕总高度的差值，如果差值大于系统默认键盘的最小高度阈值（200dp/pt），即可判定键盘处于弹出状态
• 注意：计算操作要放在点击事件的同步执行栈里，不要等异步的视图测量回调触发后再执行，不然会拿到滞后的旧测量值

iOS 端精准实现 #

• 不要仅靠keyboardWillShow/keyboardWillHide通知维护的状态做判断，按钮点击时主动通过窗口场景的输入状态同步拉取键盘实时frame

  // 点击事件内同步执行
  let scene = UIApplication.shared.connectedScenes.first as? UIWindowScene
  let keyboardFrame = scene?.windows.first?.textInputFrame ?? .zero
  

• 判断逻辑：如果实时获取到的键盘frame高度大于0，且frame底部位置低于屏幕底部安全区位置，就说明键盘处于弹出状态
• 兼容第三方输入法场景：额外校验当前第一响应者是否处于可输入状态，避免把输入法的临时候选栏弹层误判为键盘未弹出

Android 端精准实现 #

• 不要依赖全局注册的布局监听回调里缓存的键盘高度值，按钮点击触发时主动通过窗口insets接口拉取最新的软键盘高度

  // 点击事件内同步执行
  val decorView = activity.window.decorView
  val currentInsets = ViewCompat.getRootWindowInsets(decorView)
  val imeHeight = currentInsets?.getInsets(WindowInsetsCompat.Type.ime())?.bottom ?: 0
  

• 判断逻辑：如果同步获取到的IME（软键盘）高度大于100dp的阈值，就判定键盘处于弹出状态
• 特殊兼容：如果应用开启了全屏/沉浸式模式，计算时要排除系统导航栏、状态栏的高度差值，避免把系统栏高度误算为键盘高度造成误判

通用避坑要点 #

• 不要把输入框焦点状态作为唯一判断依据：遇到系统输入法弹起但焦点临时被临时控件抢走的场景，会出现判断偏差
• 不要固化键盘高度判断阈值：不同机型、不同输入法的默认键盘高度差可达200dp以上，对比当前差值和应用历史记录的平均键盘高度，比写死固定阈值的准确率更高
• 不要在按钮点击事件外提前缓存键盘状态再供点击事件读取：缓存的状态永远存在滞后可能，同步实时查询的方案才能保证点击瞬间的判断准确

内容的提问来源于stack exchange，提问作者Darren Zou