如何禁用Flutter中SearchDelegate类的自动弹出键盘功能？

核心思路是自定义搜索栏的焦点管理，因为默认的SearchDelegate会自动让搜索框获取焦点导致键盘弹出。由于_focusNode是私有属性无法直接使用，我们可以通过重写buildAppBar方法，手动创建并控制焦点节点来实现需求。

具体实现步骤 #

• 在自定义的SearchDelegate子类中，创建独立的FocusNode用于管理搜索框焦点状态。
• 重写buildAppBar方法，自定义包含搜索框的AppBar，绑定自定义焦点节点，初始不自动请求焦点。
• 给搜索框添加onTap事件，点击时主动请求焦点触发键盘弹出。
• 在close方法中销毁焦点节点，避免内存泄漏。

完整代码示例 #

class CustomSearchDelegate extends SearchDelegate<String> {
  // 自定义焦点节点
  final FocusNode _searchFocusNode = FocusNode();

  @override
  Widget buildAppBar(BuildContext context) {
    return AppBar(
      leading: IconButton(
        icon: const Icon(Icons.arrow_back),
        onPressed: () => close(context, ''),
      ),
      title: TextField(
        // 绑定SearchDelegate的query控制器，保证输入内容同步
        controller: queryController,
        // 绑定自定义焦点节点
        focusNode: _searchFocusNode,
        decoration: const InputDecoration(
          hintText: '请输入搜索内容',
          border: InputBorder.none,
        ),
        // 点击搜索框时才请求焦点，弹出键盘
        onTap: () => _searchFocusNode.requestFocus(),
        // 同步输入内容到SearchDelegate的query属性
        onChanged: (value) {
          query = value;
          showSuggestions(context);
        },
      ),
      actions: [
        IconButton(
          icon: const Icon(Icons.clear),
          onPressed: () {
            query = '';
            queryController.clear();
            // 清除焦点，收起键盘
            _searchFocusNode.unfocus();
          },
        ),
      ],
    );
  }

  @override
  Widget buildSuggestions(BuildContext context) {
    // 替换为你的搜索建议列表逻辑
    return ListView.builder(
      itemCount: 0,
      itemBuilder: (context, index) => ListTile(title: Text('建议$index')),
    );
  }

  @override
  Widget buildResults(BuildContext context) {
    // 替换为你的搜索结果展示逻辑
    return Center(child: Text('搜索结果：$query'));
  }

  @override
  void close(BuildContext context, String result) {
    // 销毁焦点节点，避免内存泄漏
    _searchFocusNode.dispose();
    super.close(context, result);
  }
}

调用方式 #

在需要触发搜索的位置调用：

showSearch(context: context, delegate: CustomSearchDelegate());

实现后，打开搜索页面时键盘不会自动弹出，仅在点击搜索框时才会触发键盘弹出，完全符合需求。

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