如何为com.google.android.material.search.SearchView实现过滤？替换AppCompat版本后无法弹出

一、为Material SearchView实现过滤功能 #

Material的com.google.android.material.search.SearchView可通过监听内部输入文本变化，结合列表Adapter的过滤逻辑实现实时搜索，具体步骤如下：

1. 绑定SearchBar与SearchView的交互 #

先确保点击SearchBar能正常唤起SearchView：

SearchBar searchBar = findViewById(R.id.search_bar);
SearchView searchView = findViewById(R.id.search_view);

// 让SearchView锚定SearchBar，保证弹出位置正确
searchView.setAnchorView(searchBar);
// 点击SearchBar弹出SearchView
searchBar.setOnClickListener(v -> searchView.show());
// 点击SearchBar的返回按钮关闭SearchView
searchBar.setNavigationOnClickListener(v -> searchView.hide());

2. 监听输入文本触发过滤 #

获取SearchView内部的EditText，添加文本监听器实时处理搜索关键词：

searchView.getEditText().addTextChangedListener(new TextWatcher() {
    @Override
    public void beforeTextChanged(CharSequence s, int start, int count, int after) {}

    @Override
    public void onTextChanged(CharSequence s, int start, int before, int count) {
        String searchQuery = s.toString().trim();
        // 触发列表Adapter的过滤逻辑
        if (yourItemAdapter != null) {
            yourItemAdapter.getFilter().filter(searchQuery);
        }
    }

    @Override
    public void afterTextChanged(Editable s) {}
});

3. 让RecyclerView Adapter支持过滤 #

给Adapter实现Filterable接口，重写过滤逻辑：

public class YourItemAdapter extends RecyclerView.Adapter<YourItemAdapter.ViewHolder> implements Filterable {
    private List<YourItem> originalItems;
    private List<YourItem> filteredItems;

    public YourItemAdapter(List<YourItem> items) {
        this.originalItems = new ArrayList<>(items);
        this.filteredItems = new ArrayList<>(items);
    }

    // ... 实现Adapter的onCreateViewHolder、onBindViewHolder等核心方法

    @Override
    public Filter getFilter() {
        return new Filter() {
            @Override
            protected FilterResults performFiltering(CharSequence constraint) {
                FilterResults results = new FilterResults();
                List<YourItem> tempList = new ArrayList<>();
                String query = constraint.toString().toLowerCase(Locale.getDefault());

                // 遍历原始列表，筛选匹配项（这里以匹配名称为例）
                for (YourItem item : originalItems) {
                    if (item.getName().toLowerCase(Locale.getDefault()).contains(query)) {
                        tempList.add(item);
                    }
                }

                results.values = tempList;
                results.count = tempList.size();
                return results;
            }

            @Override
            protected void publishResults(CharSequence constraint, FilterResults results) {
                filteredItems.clear();
                filteredItems.addAll((List<YourItem>) results.values);
                notifyDataSetChanged();
            }
        };
    }
}

二、AppCompat SearchView替换后无法弹出的解决办法 #

Material的SearchBar是为配套Material SearchView设计的，直接替换为androidx.appcompat.widget.SearchView不会自动触发弹出逻辑，需手动控制显示/隐藏：

1. 修改布局 #

将AppCompat SearchView初始设为隐藏：

<androidx.appcompat.widget.SearchView
    android:id="@+id/appcompat_search_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:visibility="gone"
    app:layout_anchor="@id/search_bar"/>

2. 手动控制SearchView的显示与隐藏 #

在代码中处理SearchBar的点击事件：

SearchBar searchBar = findViewById(R.id.search_bar);
androidx.appcompat.widget.SearchView appcompatSearchView = findViewById(R.id.appcompat_search_view);

// 点击SearchBar显示AppCompat SearchView并展开
searchBar.setOnClickListener(v -> {
    appcompatSearchView.setVisibility(View.VISIBLE);
    appcompatSearchView.setIconified(false);
    appcompatSearchView.requestFocus();
});

// 关闭SearchView时隐藏
appcompatSearchView.setOnCloseListener(() -> {
    appcompatSearchView.setVisibility(View.GONE);
    return true;
});

3. 为AppCompat SearchView添加过滤逻辑 #

使用OnQueryTextListener监听输入变化：

appcompatSearchView.setOnQueryTextListener(new androidx.appcompat.widget.SearchView.OnQueryTextListener() {
    @Override
    public boolean onQueryTextSubmit(String query) {
        // 处理搜索提交逻辑
        return false;
    }

    @Override
    public boolean onQueryTextChange(String newText) {
        // 触发Adapter过滤
        if (yourItemAdapter != null) {
            yourItemAdapter.getFilter().filter(newText);
        }
        return false;
    }
});

提示：优先使用Material系列的SearchBar+SearchView组合，它们自带锚定动画、交互逻辑，无需额外处理细节。

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