如何在Flutter中全局修改应用键盘默认Send按钮的行为？

要实现全局覆盖键盘"Send"或默认提交按钮的行为，无需逐个修改TextField/TextFormField，可通过两种核心思路实现：全局焦点监听拦截提交回调、或全局RawKeyboardListener捕获键盘事件。

方案一：通过FocusManager监听焦点，替换提交回调 #

利用Flutter的FocusManager全局监听焦点变化，当输入框获得焦点时，替换其默认的提交回调逻辑。

示例代码 #

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
  // 注册全局焦点变化监听
  FocusManager.instance.addListener(_onFocusChanged);
}

void _onFocusChanged() {
  final primaryFocus = FocusManager.instance.primaryFocus;
  // 判断当前焦点是否属于输入框
  if (primaryFocus != null && primaryFocus.context != null) {
    final textField = primaryFocus.context!.findAncestorWidgetOfExactType<TextField>();
    final textFormField = primaryFocus.context!.findAncestorWidgetOfExactType<TextFormField>();
    
    // 统一处理TextField和TextFormField
    final targetField = textField ?? textFormField;
    if (targetField == null) return;

    // 获取输入框的TextInputConnection，替换提交回调
    final connection = PrimaryFocus.instance?.textInputConnection;
    if (connection != null && !connection.closed) {
      connection.setSubmittedCallback(() {
        // 这里编写你的全局自定义逻辑
        final inputText = targetField is TextField 
            ? targetField.controller?.text 
            : (targetField as TextFormField).controller?.text;
        print("全局触发提交动作，输入内容：$inputText");
        
        // 可选操作：清空输入框
        (targetField is TextField ? targetField.controller : (targetField as TextFormField).controller)?.clear();
        
        // 可选：保留原提交逻辑（如果需要）
        // targetField.onSubmitted?.call(inputText ?? "");
        
        // 关闭键盘连接（如需收起键盘）
        connection.close();
        return Future.value(null);
      });
    }
  }
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '全局键盘示例',
      home: Scaffold(
        appBar: AppBar(title: const Text('全局自定义键盘提交')),
        body: const Padding(
          padding: EdgeInsets.all(16.0),
          child: Column(
            children: [
              TextField(
                decoration: InputDecoration(hintText: '普通输入框'),
                textInputAction: TextInputAction.send,
              ),
              SizedBox(height: 16),
              TextFormField(
                decoration: InputDecoration(hintText: '表单输入框'),
                textInputAction: TextInputAction.done,
              ),
              SizedBox(height: 16),
              TextField(decoration: InputDecoration(hintText: '默认提交按钮输入框')),
            ],
          ),
        ),
      ),
    );
  }
}

方案二：全局RawKeyboardListener捕获键盘事件 #

通过在根Widget外层包裹RawKeyboardListener，直接监听键盘的Enter键（对应各类提交按钮），拦截并执行自定义逻辑。

示例代码 #

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return RawKeyboardListener(
      focusNode: FocusNode(),
      onKey: (RawKeyEvent event) {
        // 只处理按下Enter键的事件
        if (event is RawKeyDownEvent && event.logicalKey == LogicalKeyboardKey.enter) {
          final primaryFocus = FocusManager.instance.primaryFocus;
          if (primaryFocus != null && primaryFocus.context != null) {
            // 定位当前焦点的输入框
            final textField = primaryFocus.context!.findAncestorWidgetOfExactType<TextField>();
            final textFormField = primaryFocus.context!.findAncestorWidgetOfExactType<TextFormField>();
            final targetField = textField ?? textFormField;
            
            if (targetField != null) {
              // 自定义逻辑：根据textInputAction区分处理（可选）
              if (targetField.textInputAction == TextInputAction.send) {
                print("全局处理Send按钮，输入内容：${targetField.controller?.text}");
              } else {
                print("全局处理默认提交按钮，输入内容：${targetField.controller?.text}");
              }
              
              // 阻止默认行为，避免触发输入框自身的onSubmitted
              event.handled = true;
              // 可选：收起键盘
              primaryFocus.unfocus();
            }
          }
        }
      },
      child: MaterialApp(
        title: '全局键盘监听示例',
        home: Scaffold(
          appBar: AppBar(title: const Text('全局键盘事件捕获')),
          body: const Padding(
            padding: EdgeInsets.all(16.0),
            child: Column(
              children: [
                TextField(
                  decoration: InputDecoration(hintText: 'Send按钮输入框'),
                  textInputAction: TextInputAction.send,
                ),
                SizedBox(height: 16),
                TextField(decoration: InputDecoration(hintText: 'Done按钮输入框'), textInputAction: TextInputAction.done),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

注意事项 #

• 若需保留个别输入框的默认行为，可通过给输入框设置唯一Key，在全局监听中判断并跳过处理。
• 不同平台的键盘提交按钮可能对应不同的LogicalKeyboardKey，需在目标平台测试验证。
• 方案一中的TextInputConnection需确保未关闭，否则替换回调无效。

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