Android搜索框组件SearchView的使用

忘是亡心i 2022-05-23 12:23 191阅读 0赞

# 一、SearchView概述 #

SearchView是搜索框组件，它可以让用户在文本框内输入文字，并允许通过监听器监控用户输入，当用户输入完成后提交搜索时，也可通过监听器执行实际的搜索。

SearchView默认是展示一个search的icon，点击icon展开搜索框，也可以自己设定图标。用SearchView时可指定如下表所示的常见XML属性及相关方法。

![5b687e63d4733d3391f930a67b631471.png][]

如果为SearchView增加一个配套的ListView，则可以为SearchView增加自动完成的功能。

# 二、SearchView概述 #

接下来通过一个简单的示例程序来学习SearchView的使用。

继续使用WidgetSample工程的advancedviewsample模块，在app/main/res/layout/目录下创建searchview\_layout.xml文件，在其中填充如下代码片段：

<?xml version="1.0" encoding="utf-8"?>  
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
              android:layout\_width="match\_parent"  
              android:layout\_height="match\_parent"  
              android:layout\_margin="15dp"  
              android:orientation="vertical" >  
   
    <SearchView  
        android:id="@+id/searchView"  
        android:layout\_width="match\_parent"  
        android:layout\_height="wrap\_content"  
        android:iconifiedByDefault="false"  
        android:queryHint="请输入搜索内容" />  
   
    <ListView  
        android:id="@+id/listView"  
        android:layout\_width="match\_parent"  
        android:layout\_height="0dp"  
        android:layout\_weight="1" />  
</LinearLayout>

上面的布局文件中定义了一个SearchView组件，并为该SearchView组件定义了一个 ListView组件，该ListView组件用于为SearchView组件显示不自动完成列表。

接下来为SearchView编写操作控制代码，并为其添加监听器。新建SearchViewActivity.java文件，加载上面新建的布局文件，具体代码如下：

package com.jinyu.cqkxzsxy.android.advancedviewsample;  
   
import android.os.Bundle;  
import android.support.v7.app.AppCompatActivity;  
import android.text.TextUtils;  
import android.widget.ArrayAdapter;  
import android.widget.ListView;  
import android.widget.SearchView;  
   
  
public class SearchViewActivity extends AppCompatActivity \{  
    private SearchView mSearchView = null;  
    private ListView mListView = null;  
    private String\[\] mDatas = \{"aaa", "bbb", "ccc", "airsaid"\};  
   
    @Override  
    protected void onCreate(Bundle savedInstanceState) \{  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.searchview\_layout);  
   
        mSearchView = (SearchView) findViewById(R.id.searchView);  
        mListView = (ListView) findViewById(R.id.listView);  
        mListView.setAdapter(new ArrayAdapter<String>(this,  
                android.R.layout.simple\_list\_item\_1, mDatas));  
        mListView.setTextFilterEnabled(true);  
   
        // 设置搜索文本监听  
        mSearchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() \{  
            // 当点击搜索按钮时触发该方法  
            @Override  
            public boolean onQueryTextSubmit(String query) \{  
                return false;  
            \}  
   
            // 当搜索内容改变时触发该方法  
            @Override  
            public boolean onQueryTextChange(String newText) \{  
                if (!TextUtils.isEmpty(newText))\{  
                    mListView.setFilterText(newText);  
                \}else\{  
                    mListView.clearTextFilter();  
                \}  
                return false;  
            \}  
        \});  
    \}  
\}

修改启动的Activity，运行程序，可以看到下图左侧所示界面效果。

![5c1cd8bd7d5d13ae434faa073fdcd4cf.png][]

在搜索框中输入内容后，可以看到上图右侧所示筛选效果

[5b687e63d4733d3391f930a67b631471.png]: /images/20220523/08067ceecb914641859d8a3c799bc21d.png
[5c1cd8bd7d5d13ae434faa073fdcd4cf.png]: /images/20220523/7dc08618f2f248d1845f5161a4bd9d47.png