用户点击搜索图标前调用SearchView.setQuery()无效的问题

这问题我太熟了！之前做项目的时候也踩过这个坑——当SearchView还处于折叠状态（用户没点击搜索图标展开它）时，直接调用setQuery()是不会有任何效果的，因为此时SearchView的内部视图还没完成初始化，处于不可交互的状态。

要解决这个问题，核心思路是先强制展开SearchView的ActionView，再设置查询文本，具体步骤如下：

1. 保存Search对应的MenuItem引用 #

首先在onCreateOptionsMenu中获取并保存MenuItem的引用，方便后续调用：

private MenuItem searchMenuItem;

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.your_menu_resource, menu);
    // 获取搜索项的MenuItem
    searchMenuItem = menu.findItem(R.id.search_toolbar_main);
    return super.onCreateOptionsMenu(menu);
}

2. 编写展开并设置查询文本的方法 #

创建一个方法，先展开SearchView，再获取实例并设置查询内容：

private void launchSearchWithPreFillText(String preFillText) {
    if (searchMenuItem == null) return;

    // 第一步：强制展开SearchView的ActionView
    searchMenuItem.expandActionView();

    // 第二步：获取SearchView实例
    SearchView searchView = (SearchView) searchMenuItem.getActionView();
    if (searchView == null) return;

    // 第三步：设置查询文本，第二个参数传false表示仅显示文本不自动提交搜索
    searchView.setQuery(preFillText, false);

    // 可选：让搜索框自动获取焦点，提升用户体验
    searchView.requestFocus();
}

3. 调用方法触发搜索 #

在你需要的地方（比如页面加载完成、某个按钮点击事件）调用这个方法即可：

// 示例：页面加载完成后自动展开搜索并填充文本
@Override
protected void onResume() {
    super.onResume();
    // 这里可以替换成你需要的默认搜索文本
    launchSearchWithPreFillText("预设搜索内容");
}

额外注意事项 #

• 如果在onCreate中直接调用方法，可能因为菜单还未完全初始化导致失败，此时可以通过post延迟执行：

  getWindow().getDecorView().post(() -> launchSearchWithPreFillText("预设搜索内容"));
  

• 如果你需要设置完文本后自动触发搜索，只需要把setQuery的第二个参数改成true即可。

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