React Native Keyboard Controller 中 TextInput 的 focusDidSet 问题解析

在 React Native 开发中，react-native-keyboard-controller 是一个常用的键盘控制库。最近发现了一个关于 TextInput 组件在特定配置下 focusDidSet 回调不触发的问题，本文将深入分析问题原因及解决方案。

问题现象

当 TextInput 组件设置了 showSoftInputOnFocus={false} 属性时，focusDidSet 回调不会被触发。这导致了一些依赖焦点状态的功能无法正常工作，特别是当开发者需要实现自定义键盘或焦点控制逻辑时。

问题根源

经过分析，问题的核心在于库内部是通过监听键盘显示事件（keyboardWillShow）来触发 focusDidSet 回调的。这种设计存在以下缺陷：

1. 当 showSoftInputOnFocus 设为 false 时，键盘不会自动弹出，因此 keyboardWillShow 事件不会被触发
2. 在 iPad 连接物理键盘的情况下，同样不会触发键盘显示事件
3. 这种设计将焦点状态与键盘显示状态过度耦合

技术背景

在 iOS 开发中，UITextField/UITextView 的焦点状态变化主要通过 becomeFirstResponder 和 resignFirstResponder 方法来控制。而键盘显示/隐藏则是这些方法的副作用。

React Native 的 TextInput 组件提供了 showSoftInputOnFocus 属性，允许开发者控制是否在获得焦点时自动显示软键盘。当设为 false 时，虽然输入框获得了焦点，但不会触发键盘显示流程。

解决方案

正确的做法应该是直接监听输入框的焦点状态变化，而不是依赖键盘显示事件。具体实现思路：

1. 使用 iOS 原生的 becomeFirstResponder 通知来检测焦点变化
2. 将焦点状态与键盘状态解耦
3. 确保在所有情况下（包括自定义键盘、物理键盘等场景）都能正确触发焦点回调

实际应用

这个问题特别影响以下场景的开发：

1. 自定义键盘实现
2. 表单输入流程控制
3. 多步骤输入界面
4. 需要精确控制焦点和键盘行为的应用

修复后，开发者可以更灵活地控制输入焦点，而不必担心键盘显示状态的影响。例如，可以在不显示键盘的情况下实现输入框之间的焦点切换，或者构建完全自定义的输入体验。

总结

这个问题的修复体现了在 React Native 开发中理解原生平台机制的重要性。通过将焦点检测逻辑从键盘事件中解耦，使库的行为更加符合预期，也为开发者提供了更可靠的 API。

对于需要使用自定义输入方案或特殊键盘控制的开发者来说，这个修复将大大提高开发体验和应用的稳定性。