Flutter求助：软键盘打开时向下滚动屏幕关闭键盘（auto focus无效）

方法一：全局手势监听（适配任意页面结构） #

通过GestureDetector监听整个页面的向下拖拽动作，触发软键盘关闭逻辑。

@override
Widget build(BuildContext context) {
  return GestureDetector(
    onPanUpdate: (details) {
      // 向下滑动距离超过10像素，且当前有输入焦点（软键盘打开）
      if (details.delta.dy > 10 && FocusManager.instance.primaryFocus?.hasFocus == true) {
        // 移除焦点，关闭软键盘
        FocusManager.instance.primaryFocus?.unfocus();
      }
    },
    // 确保手势能被捕获，不被子组件拦截
    behavior: HitTestBehavior.opaque,
    child: Scaffold(
      appBar: AppBar(title: const Text("滚动关闭键盘")),
      body: SingleChildScrollView(
        child: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Column(
            children: List.generate(20, (index) => TextField(decoration: InputDecoration(hintText: "输入框 $index"))),
          ),
        ),
      ),
    ),
  );
}

方法二：滚动通知监听（适配已有滚动组件的页面） #

如果页面本身使用ListView、SingleChildScrollView等滚动组件，直接通过NotificationListener监听滚动事件即可。

@override
Widget build(BuildContext context) {
  return Scaffold(
    appBar: AppBar(title: const Text("滚动关闭键盘")),
    body: NotificationListener<ScrollUpdateNotification>(
      onNotification: (notification) {
        // 检测向下滚动动作，且软键盘处于打开状态
        if (notification.delta.dy > 5 && FocusManager.instance.primaryFocus?.hasFocus == true) {
          FocusManager.instance.primaryFocus?.unfocus();
          // 返回true表示已处理该通知，不再向下传递
          return true;
        }
        return false;
      },
      child: SingleChildScrollView(
        child: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Column(
            children: List.generate(20, (index) => TextField(decoration: InputDecoration(hintText: "输入框 $index"))),
          ),
        ),
      ),
    ),
  );
}

补充说明 #

• 你之前尝试的autoFocus属性仅用于自动让输入框获取焦点打开软键盘，和滚动关闭键盘的需求无关，因此无法解决问题。
• 可根据需求调整滑动阈值（代码中的10、5），设置更灵敏或迟钝的触发条件。
• 若需复用该逻辑，可封装为自定义组件：

class ScrollHideKeyboard extends StatelessWidget {
  final Widget child;
  // 可自定义滑动阈值
  final double threshold;

  const ScrollHideKeyboard({super.key, required this.child, this.threshold = 10.0});

  @override
  Widget build(BuildContext context) {
    return GestureDetector(
      onPanUpdate: (details) {
        if (details.delta.dy > threshold && FocusManager.instance.primaryFocus?.hasFocus == true) {
          FocusManager.instance.primaryFocus?.unfocus();
        }
      },
      behavior: HitTestBehavior.opaque,
      child: child,
    );
  }
}

使用时直接包裹页面内容即可：

ScrollHideKeyboard(
  child: Scaffold(/* 页面内容 */),
)

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