Flutter Web键盘快捷键与输入框冲突、焦点失效问题求解

Flutter 快捷键事件的分发遵循从当前持有焦点的节点向上遍历，匹配到最近的Action绑定即触发的规则：

1. 外层FocusableActionDetector的快捷键绑定优先级高于子组件的默认输入响应，只要没有内层节点拦截对应按键，就会直接触发绑定动作，导致输入框无法接收到数字"2"的输入事件
2. 文本输入框完成输入后，焦点会默认转移到相邻的无快捷键绑定的焦点节点，不会自动回到外层表单的检测器节点，直接导致表单层级快捷键完全失效

不需要给输入框额外嵌套FocusableActionDetector，按以下两步修改即可：

• 给外层快捷键的触发逻辑增加焦点状态判定：仅当当前无激活的文本输入框时，才响应快捷键动作，避免和输入框的字符输入冲突
• 给表单级FocusableActionDetector绑定独立的焦点节点，在输入框提交内容时主动将焦点切回该节点，避免焦点游离导致快捷键失效

可直接参考以下实现代码：

// 定义表单级焦点节点，可放在State类中初始化、dispose时释放
final FocusNode _formShortcutFocus = FocusNode(debugLabel: 'form_shortcut_root');

@override
Widget build(BuildContext context) {
  return FocusableActionDetector(
    focusNode: _formShortcutFocus,
    shortcuts: const {
      SingleActivator(LogicalKeyboardKey.digit2): CustomActivateIntent(),
    },
    actions: {
      CustomActivateIntent: CallbackAction<CustomActivateIntent>(
        onInvoke: (intent) {
          // 检测当前是否有激活的文本输入框
          final FocusNode? currentFocus = FocusManager.instance.primaryFocus;
          final bool isTextInputActive = currentFocus?.context
                  ?.findAncestorWidgetOfExactType<EditableText>() !=
              null;
          // 输入框激活状态下不触发全局快捷键，让事件正常下发给输入框
          if (isTextInputActive) return null;
          
          // 非输入状态才执行快捷键逻辑
          provider.value = "2";
          return null;
        },
      ),
    },
    child: Form(
      child: Column(
        children: [
          TextFormField(
            keyboardType: TextInputType.number,
            onFieldSubmitted: (_) {
              // 输入完成提交后，主动将焦点切回表单根节点，保证快捷键持续可用
              _formShortcutFocus.requestFocus();
            },
          ),
          // 其余数值输入框按相同逻辑配置onFieldSubmitted即可
        ],
      ),
    ),
  );
}

补充说明 #

如果你的快捷键是带修饰键的组合键（比如Ctrl+2、Alt+2），可以直接在SingleActivator中传入control: true/alt: true等参数，这类组合键不会和输入框的普通字符输入冲突，不需要额外做焦点状态判定。

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