Android基础控件—SearchView

最新推荐文章于 2025-06-04 09:08:12 发布

ZackChu

最新推荐文章于 2025-06-04 09:08:12 发布

阅读量2.3w

点赞数 8

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/ZackChu/article/details/68488103

本文介绍了Android中的SearchView控件，它是用于用户搜索查询的原生组件。虽然其UI固定，自定义程度有限，但在一些场景下仍能提供便利。文章提到了几个关键属性的设置，如iconifiedByDefault、imeOptions、inputType、maxWidth和queryHint，并提供了相关方法以供调整。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1.SearchView是什么？

SearchView是Android原生的搜索框控件，可以很方便的添加到用户界面中，用于用户的搜索查询功能。但是SearchView的UI是固定的，自定义起来会比较麻烦，如果对SearchView的要求比较高，还是使用EditText和Button自定义实现。

2.在代码中具体实现

除此之外，SearchView还有一些简单的属性设置。

android:iconifiedByDefault：设置搜索图标是否显示在搜索框内(相关的方法setIconifiedByDefault(boolean))
android:imeOptions：设置输入法搜索选项字段，默认是搜索，可以是：下一页、发送、完成等(相关的方法setImeOptions(int))
android:inputType：设置输入类型(相关的方法setInputType(int))
android:maxWidth：设置最大宽度(相关的方法setMaxWidth(int))
android:queryHint：设置查询提示字符串(相关的方法setQueryHint(CharSequence))

接下来要使用SearchView和ListView实现查找过滤功能，实现后的效果。

首先在布局文件中需要一个SearchView和ListView。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context="com.example.chupeng.serachviewdemo.MainActivity">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1">

        <android.support.v7.widget.SearchView
            android:id="@+id/searchEdit"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:background="@drawable/search_selector"
            android:queryHint="请输入物品名称">
        </android.support.v7.widget.SearchView>

    </LinearLayout>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="8">

        <ListView
            android:id="@+id/listView"
            android:layout_width="wrap_content"
            android:layout_height="match_parent">
        </ListView>

    </LinearLayout>

</LinearLayout>

在MainActivity文件中需要监听SearchView控件

searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener()
{
    //输入完成后，提交时触发的方法，一般情况是点击输入法中的搜索按钮才会触发，表示现在正式提交了
    public boolean onQueryTextSubmit(String query)
    {
        if(TextUtils.isEmpty(query))
        {
            Toast.makeText(MainActivity.this, "请输入查找内容！", Toast.LENGTH_SHORT).show();
            listView.setAdapter(adapter);
        }
        else
        {
            findList.clear();
            for(int i = 0; i < list.size(); i++)
            {
                iconInformation information = list.get(i);
                if(information.getName().equals(query))
                {
                    findList.add(information);
                    break;
                }
            }
            if(findList.size() == 0)
            {
                Toast.makeText(MainActivity.this, "查找的商品不在列表中", Toast.LENGTH_SHORT).show();
            }
            else
            {
                Toast.makeText(MainActivity.this, "查找成功", Toast.LENGTH_SHORT).show();
                findAdapter = new listViewAdapter(MainActivity.this, findList);
                listView.setAdapter(findAdapter);
            }
        }
        return true;
    }
    //在输入时触发的方法，当字符真正显示到searchView中才触发，像是拼音，在输入法组词的时候不会触发
    public boolean onQueryTextChange(String newText)
    {
        if(TextUtils.isEmpty(newText))
        {
            listView.setAdapter(adapter);
        }
        else
        {
            findList.clear();
            for(int i = 0; i < list.size(); i++)
            {
                iconInformation information = list.get(i);
                if(information.getName().contains(newText))
                {
                    findList.add(information);
                }
            }
            findAdapter = new listViewAdapter(MainActivity.this, findList);
            findAdapter.notifyDataSetChanged();
            listView.setAdapter(findAdapter);
        }
        return true;
    }
});

从上面的代码中可以看出，监听SearchView需要实现其内部的onQueryTextSubmit和onQueryTextChange这两个方法，在这两个方法中onQueryTextSubmit是在SearchView中输入完成提交之后所触发的方法，而onQueryTextChange是在SearchView中输入时所触发的方法，当输入的字符真正显示到SearchView中才会触发，像是拼音，在输入法组词的时候不会触发。

3. 总结

SearchView如果直接使用的话是没有背景的，为了更好的仿照搜索框的样式，我们此时还需要添加背景文件，在这里我们使用XML文件的方式去实现，接下来需要三个XML文件，分别为输入框获取焦点时的背景，输入框未获取焦点时的背景，输入框的背景选择器，代码如下所示。

search_focused.xml(获取焦点)

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="#FFFFFF"/>
    <corners android:radius="3dp"/>
    <stroke
        android:width="1dp"
        android:color="#728ea3"/>
</shape>

search_normal.xml(未获取焦点)

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="#FFFFFF"/>
    <corners android:radius="3dp"/>
    <stroke
        android:width="1dp"
        android:color="#BDC7D8"/>
</shape>

search_selector.xml(背景选择器)

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_focused="true"
          android:drawable="@drawable/search_focused"/>
    <item android:state_focused="false"
          android:drawable="@drawable/search_normal"/>
</selector>

以上Demo的源代码地址：点击打开链接