Android MenuItem 使用 SearchView 实现搜索功能

在 Android 开发中，使用 SearchView 组件可以帮助用户方便地进行搜索。本文将会为刚入行的小白详细介绍如何在 Android 应用中实现 MenuItem 使用 SearchView 的步骤。

整体流程

以下是实现“Android MenuItem 使用 SearchView”的整个流程，清晰展示了每个步骤的执行顺序。

步骤详解

下面将详细介绍以上每个步骤。

步骤 1：创建菜单

代码：

在 res/menu 目录下，创建 menu_main.xml 文件，内容如下：

<menu xmlns:android="
    <item
        android:id="@+id/action_search"
        android:title="@string/search"
        android:icon="@android:drawable/ic_search"
        android:showAsAction="ifRoom|collapseActionView"
        android:actionViewClass="android.widget.SearchView"/>
</menu>

注释：

• 定义了一个菜单项，包括图标、标题、显示方式以及指明它是一个 SearchView。

步骤 2：实现 SearchView

代码：

在主活动 MainActivity.java 中重写 onCreateOptionsMenu() 方法：

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.menu_main, menu);
    MenuItem searchItem = menu.findItem(R.id.action_search);
    
    // 获取 SearchView 实例
    SearchView searchView = (SearchView) searchItem.getActionView();
    searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
        @Override
        public boolean onQueryTextSubmit(String query) {
            // 提交搜索
            return false;
        }

        @Override
        public boolean onQueryTextChange(String newText) {
            // 输入文本变化
            filter(newText);
            return true;
        }
    });
    return true;
}

注释：

• 使用 getMenuInflater() 方法加载自定义菜单。
• 取得 SearchView 实例并设置查询文本监听器。

步骤 3：处理搜索事件

代码：

实现 filter(String query) 方法进行数据过滤：

private void filter(String text) {
    List<String> filteredList = new ArrayList<>();
    for (String item : originalList) {
        if (item.toLowerCase().contains(text.toLowerCase())) {
            filteredList.add(item);
        }
    }
    adapter.updateList(filteredList); // 假设你已经有了一个适配器
}

注释：

• 将输入文本与数据集进行比较，并将匹配的结果添加到 filteredList 中。

步骤 4：更新视图

代码：

在适配器中实现 updateList(List<String> list) 方法：

public void updateList(List<String> newList) {
    this.items = newList; // 更新适配器数据
    notifyDataSetChanged(); // 通知数据已更新
}

注释：

• 使用 notifyDataSetChanged() 方法更新用户界面上的数据。

甘特图

gantt
    title Android MenuItem 使用 SearchView 实现搜索功能
    dateFormat  YYYY-MM-DD
    section 创建菜单
    创建菜单           :done,  des1, 2023-10-01, 1d
    section 实现 SearchView
    实现 SearchView    :done,  des2, after des1, 1d
    section 处理搜索事件
    处理搜索事件      :done,  des3, after des2, 1d
    section 更新视图
    更新视图           :done,  des4, after des3, 1d

结尾

本文简单介绍了如何在 Android 应用中使用 MenuItem 和 SearchView 实现搜索功能。通过这些步骤，你可以创造出一个用户友好的搜索体验。希望以上内容能够帮助你快速上手，如果你有任何疑问，请随时提问，祝你开发顺利！