Flutter中打开Drawer时键盘无法正常收起问题

在使用SingleChildScrollView并设置keyboardDismissBehavior: ScrollViewKeyboardDismissBehavior.onDrag时，打开Drawer的操作并不会触发该滚动视图的拖动行为，因此键盘无法自动收起。要实现打开Drawer时自动收起键盘，可以通过以下两种简单方式解决：

方法一：打开Drawer前主动收起键盘 #

在触发打开Drawer的操作（比如点击菜单按钮）时，先调用键盘收起方法，再打开Drawer：

IconButton(
  icon: const Icon(Icons.menu),
  onPressed: () {
    // 收起当前焦点关联的键盘
    FocusManager.instance.primaryFocus?.unfocus();
    // 打开Drawer
    Scaffold.of(context).openDrawer();
  },
)

如果使用AppBar自动生成的leading按钮，只需自定义leading即可实现相同逻辑。

方法二：在Drawer初始化时自动收起键盘 #

通过Drawer的State生命周期，在Drawer渲染完成后主动收起键盘：

class CustomDrawer extends StatefulWidget {
  const CustomDrawer({super.key});

  @override
  State<CustomDrawer> createState() => _CustomDrawerState();
}

class _CustomDrawerState extends State<CustomDrawer> {
  @override
  void initState() {
    super.initState();
    // 等待Drawer渲染完成后执行键盘收起操作
    WidgetsBinding.instance.addPostFrameCallback((_) {
      FocusScope.of(context).unfocus();
    });
  }

  @override
  Widget build(BuildContext context) {
    return Drawer(
      child: ListView(
        padding: EdgeInsets.zero,
        children: const [
          DrawerHeader(
            decoration: BoxDecoration(color: Colors.blue),
            child: Text('Drawer Header'),
          ),
          ListTile(title: Text('Item 1')),
          ListTile(title: Text('Item 2')),
        ],
      ),
    );
  }
}

原理说明 #

ScrollViewKeyboardDismissBehavior.onDrag仅在拖动滚动视图本身时才会触发键盘收起，而打开Drawer的操作不属于该滚动视图的拖动事件，因此必须通过主动调用焦点管理的方法来强制收起键盘。

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