Flutter Android：使用蓝牙键盘时防止屏幕边缘高亮

当Android系统检测到键盘输入但当前没有获得焦点的输入控件时，会显示绿色的焦点高亮边框。以下是几种无需添加虚拟TextField的解决方案：

方法一：使用Focus控件管理焦点并处理键盘事件 #

通过Focus和FocusScope让页面容器获得焦点，同时禁用系统默认的焦点高亮，并直接处理键盘输入事件。

class NoTextFieldPage extends StatefulWidget {
  @override
  _NoTextFieldPageState createState() => _NoTextFieldPageState();
}

class _NoTextFieldPageState extends State<NoTextFieldPage> {
  late FocusNode _focusNode;

  @override
  void initState() {
    super.initState();
    _focusNode = FocusNode();
    // 页面构建完成后请求焦点
    WidgetsBinding.instance.addPostFrameCallback((_) {
      FocusScope.of(context).requestFocus(_focusNode);
    });
  }

  @override
  void dispose() {
    _focusNode.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return FocusScope(
      node: FocusScopeNode(),
      child: Focus(
        focusNode: _focusNode,
        canRequestFocus: true,
        // 拦截并处理键盘事件，避免系统传递触发高亮
        onKey: (node, event) {
          if (event is RawKeyDownEvent) {
            // 这里替换成你的键盘输入处理逻辑
            print('按下按键: ${event.logicalKey.keyLabel}');
          }
          return KeyEventResult.handled;
        },
        child: Container(
          color: Colors.white,
          child: const Center(
            child: Text('无TextField页面'),
          ),
        ),
      ),
    );
  }
}

优点：仅对当前页面生效，不影响其他页面的焦点反馈，同时能直接处理键盘输入。

方法二：修改Android全局主题禁用焦点高亮 #

在Android项目的主题配置中全局关闭默认焦点高亮，适合整个应用都不需要该反馈的场景。

打开android/app/src/main/res/values/styles.xml，修改AppTheme：

<style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 保留原有主题属性 -->
    <item name="android:defaultFocusHighlightEnabled">false</item>
</style>

优点：配置简单，全局生效；缺点：会移除所有控件的默认焦点高亮效果，可能影响用户交互体验。

方法三：使用RawKeyboardListener监听键盘事件 #

通过RawKeyboardListener绑定焦点节点，监听键盘输入的同时让页面获得焦点，避免系统触发高亮。

class NoTextFieldPage extends StatefulWidget {
  @override
  _NoTextFieldPageState createState() => _NoTextFieldPageState();
}

class _NoTextFieldPageState extends State<NoTextFieldPage> {
  late FocusNode _focusNode;

  @override
  void initState() {
    super.initState();
    _focusNode = FocusNode();
    WidgetsBinding.instance.addPostFrameCallback((_) {
      FocusScope.of(context).requestFocus(_focusNode);
    });
  }

  @override
  void dispose() {
    _focusNode.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return RawKeyboardListener(
      focusNode: _focusNode,
      onKey: (event) {
        if (event is RawKeyDownEvent) {
          // 处理键盘输入逻辑
          print('键盘输入: ${event.logicalKey.keyLabel}');
        }
      },
      child: Container(
        color: Colors.white,
        child: const Center(child: Text('无TextField页面')),
      ),
    );
  }
}

优点：实现简洁，专注于键盘事件监听，同样不会影响全局设置。

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