介绍
大多APP都具有搜索功能，但是大部分都是在标题栏中放置搜索的图标或者是不可输入的EditText，当点击的时候，开启另外一个界面进行搜索，但是网易云音乐在搜索本地音乐的时候，点击搜索按钮，就会出现输入框，点击返回时，又会再次收起，以前认为需要自己根据状态做布局的改变，最后发现原来有一个很方便好用的控件，叫做SearchView，现在开始学习下如何使用SearchView。
网易云音乐的效果如下：
使用SearchView
SearchView需要和Toolbar一起使用，如果不熟悉Toolbar的使用，可以查看我写过的介绍Toolbar的文章：
MaterialDesign学习篇(二)，Toolbar、DrawerLayout的使用
创建带SearchView的menu
在res->menu文件夹中我们新建一个叫做menu_search_view.xml的文件，文件的内容为：
<?xml version="1.0" encoding="utf-8"?><menu xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto"> <!--右侧搜索操作条目--> <item android:id="@+id/action_search" android:title="@string/menu_search" app:actionViewClass="android.support.v7.widget.SearchView" app:showAsAction="always"/> <!--右侧设置条目，收起--> <item android:id="@+id/action_setting" android:title="@string/menu_setting" app:showAsAction="never" /></menu>
其中第一个是搜索的条目，我们指定了它的actionViewClass="android.support.v7.widget.SearchView"，这就表明它是一个SearchView，和其他的菜单条目不同，下面会给大家演示它的不同之处。
布局文件中使用Toolbar
<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical"> <android.support.v7.widget.Toolbar android:id="@+id/toolbar" android:background="@color/netease_red" android:layout_width="match_parent" android:layout_height="wrap_content" app:title="我的音乐" app:titleTextColor="@android:color/white" /></LinearLayout>
Activity中展示Toolbar和Menu
找到Toolbar对象，调用setSupportActionBar()方法，重写onCreateOptionsMenu()方法展示右侧菜单项
public class SearchViewActivity extends AppCompatActivity { @Override
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);
supportRequestWindowFeature(Window.FEATURE_NO_TITLE);
setContentView(R.layout.activity_search_view);
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
setSupportActionBar(toolbar);
} @Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.menu_search_view, menu); //找到searchView
MenuItem searchItem = menu.findItem(R.id.action_search);
SearchView searchView = (SearchView) MenuItemCompat.getActionView(searchItem); return super.onCreateOptionsMenu(menu);
}
}效果如图：
可以看到，右侧放置有搜索的图标和竖立的三点水(更多)，搜索的图标并没有指定，是系统自带的，由于指定了actionViewClass属性为android.support.v7.widget.SearchView,所以该菜单项具有搜索的功能，点击后会展现出搜索框，如果输入框中有内容，当点击搜索框右侧的关闭时，会清除文本框中的内容，如果输入框中没有内容，点击关闭图标时，它会收起来，变成原来的搜索图标。
更改默认图标的颜色
上图中图标的颜色是黑色的，看起来是不是有些不堪入目，是不是很想改变它的颜色，改变菜单项图标的颜色不难，只需要在Activity的主题中，指定Toolbar菜单项图标的颜色:
<style name="SeachViewActivityTheme" parent="Theme.AppCompat.Light.DarkActionBar"> <item name="colorPrimary">@color/netease_red</item> <item name="colorPrimaryDark">@color/netease_red</item> <item name="colorAccent">@color/netease_red</item> <!--toolbar菜单项图标的颜色--> <item name="android:textColorSecondary">@android:color/white</item></style>
只需要设置android:textColorSecondary,指定Toolbar中菜单项图标的颜色，我们现在把它指定为white,效果如下：
是不是觉得好看多了，顿时觉得界面清新了许多。
设置SearchView的展开样式
一、让SearchView一开始就处于展开状态：
代码：
searchView.setIconified(false);//一开始处于展开状态
可以看到SearchView一开始处于展开的状态，而且关闭的图标也显示出来，当输入框中有内容的时候，点击关闭的图标是清除内容，当输入框中没有内容的时候，点击关闭图标是收起张开状态。
二、设置SearchView无法收起
代码：
searchView.setIconified(false);//设置searchView处于展开状态searchView.onActionViewExpanded();// 当展开无输入内容的时候，没有关闭的图标
可以看到SearchView一开始处于展开的状态，但是关闭的图标一开始没有显示出来，所以无法收起展开状态，当输入框中有内容的时候，点击关闭的图标是清除内容。
三、设置搜索小图标的位置在框外
代码：
searchView.setIconified(false);//设置searchView处于展开状态searchView.onActionViewExpanded();// 当展开无输入内容的时候，没有关闭的图标searchView.setIconifiedByDefault(false);//默认为true在框内，设置false则在框外
可以看到，第三张图的效果和第二张图的差不多，只不过搜索的小图标是在输入框外而不是输入框内。
SearchView的监听
内容变化以及点击提交的监听
代码：
searchView.setSubmitButtonEnabled(true);//显示提交按钮
searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() { @Override
public boolean onQueryTextSubmit(String query) { //提交按钮的点击事件
Toast.makeText(SearchViewActivity.this, query, Toast.LENGTH_SHORT).show(); return true;
} @Override
public boolean onQueryTextChange(String newText) { //当输入框内容改变的时候回调
Log.i(TAG,"内容: " + newText); return true;
}
});log截图：
上图中可以看到，输入框的右侧有一个">"图标，即提交按钮，按钮的点击事件在onQueryTextSubmit()方法中回调处理，这里我只是简单弹出搜索框中的内容，当输入框中的内容变化时，会在onQueryTextChange()方法中回调，这里我将变化的内容打印在控制台。
设置无内容时的提示文字
searchView.setQueryHint("输入歌曲名查找");//设置默认无内容时的文字提示修改搜索图标
想要修改默认的搜索图标，需要在Activity的主题中修改，像刚才修改默认图标的颜色一样，需要在style.xml中对应Activity的主题中进行修改：
<style name="SeachViewActivityTheme" parent="Theme.AppCompat.Light.DarkActionBar"> <item name="colorPrimary">@color/netease_red</item> <item name="colorPrimaryDark">@color/netease_red</item> <item name="colorAccent">@color/netease_red</item> <!--toolbar菜单项图标的颜色--> <item name="android:textColorSecondary">@android:color/white</item> <!--修改searchView样式--> <item name="searchViewStyle">@style/SearchViewStyle</item></style><style name="SearchViewStyle" parent="Widget.AppCompat.SearchView"> <item name="searchIcon">@mipmap/ic_search</item></style>
可以看到搜索图标变成自己指定的图标了，无论是展开还是收起状态，图标都改变了.
修改输入框文字提示的颜色和内容文字的颜色
mSearchAutoComplete = (SearchView.SearchAutoComplete) mSearchView.findViewById(R.id.search_src_text); //设置输入框提示文字样式 mSearchAutoComplete.setHintTextColor(getResources().getColor(android.R.color.white));//设置提示文字颜色 mSearchAutoComplete.setTextColor(getResources().getColor(android.R.color.white));//设置内容文字颜色
可以看到，提示文字的颜色和内容文字的颜色都变成白色了。
去除搜索框中的图标
<style name="SeachViewActivityTheme" parent="Theme.AppCompat.Light.DarkActionBar"> <item name="colorPrimary">@color/netease_red</item> <item name="colorPrimaryDark">@color/netease_red</item> <item name="colorAccent">@color/netease_red</item> <!--toolbar菜单项图标的颜色--> <item name="android:textColorSecondary">@android:color/white</item> <!--修改searchView样式--> <item name="searchViewStyle">@style/SearchViewStyle</item></style><style name="SearchViewStyle" parent="Widget.AppCompat.SearchView"> <item name="searchIcon">@mipmap/ic_search</item> <item name="searchHintIcon">@null</item></style>
指定SearchView样式中的searchHintIcon为null,即可去除搜索框中的图标，如图：
关联navigationIcon的点击
这里我们尝试做成跟网易云音乐一样，当搜索框处于展开的时候，点击返回键是收起SearchView,当SearchView处于收起时，点击是关闭当前Activity。
修改布局文件中的Toolbar,指定navigationIcon:
<android.support.v7.widget.Toolbar android:id="@+id/toolbar" android:background="@color/netease_red" android:layout_width="match_parent" android:layout_height="wrap_content" app:title="本地音乐" app:titleTextColor="@android:color/white" app:navigationIcon="@mipmap/back" />
Activity中，设置navigationIcon的点击事件：
toolbar.setNavigationOnClickListener(new View.OnClickListener() { @Override
public void onClick(View v) { if (mSearchAutoComplete.isShown()) { try {
mSearchAutoComplete.setText("");//清除文本
//利用反射调用收起SearchView的onCloseClicked()方法
Method method = mSearchView.getClass().getDeclaredMethod("onCloseClicked");
method.setAccessible(true);
method.invoke(mSearchView);
} catch (Exception e) {
e.printStackTrace();
}
} else {
finish();
}
}
});设置navigationIcon的点击事件时，我们判断当前SearchView是否处于显示状态，通过调用SearchAutoComplete的isShown()方法，如果处于显示状态，则清除输入框中的内容，接着通过反射调用SearchView的onCloseClicked()方法，收起SearchView；如果SearchView处于收起状态，点击则是关闭当前Activity.现在是不是觉得很接近网易云音乐的搜索本地音乐的样子了。
修改navigationIcon和SearchView之间的距离
上图中navigationIcon和SearchView之间的距离过大，我们对其进行修改，需要在style.xml定义Toolbar的样式:
<!--NavigationIcon和标题之间的距离--><style name="ToolbarStyle" parent="Base.Widget.AppCompat.Toolbar"> <item name="contentInsetStart">0dp</item> <item name="contentInsetStartWithNavigation">0dp</item></style>
在布局文件中，引用Toolbar的样式：
<android.support.v7.widget.Toolbar android:id="@+id/toolbar" android:background="@color/netease_red" android:layout_width="match_parent" android:layout_height="wrap_content" app:title="本地音乐" app:titleTextColor="@android:color/white" app:navigationIcon="@mipmap/back" />
Toolbar的样式中，我们修改了navigationIcon和title之间的距离，将其修改为0，现在看起来navigationIcon和SearchView之间的距离是不是变小了，好看些了。
模仿网易云音乐搜索本地音乐功能
先看下效果:
修改布局文件，即Toolbar + ListView：
<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical"><android.support.v7.widget.Toolbar android:id="@+id/toolbar" android:background="@color/netease_red" android:layout_width="match_parent" android:layout_height="wrap_content" app:title="本地音乐" app:titleTextColor="@android:color/white" app:navigationIcon="@mipmap/back" /><ListView android:id="@+id/lv_music" android:layout_width="match_parent" android:layout_height="match_parent" /></LinearLayout>
当搜索内容变化的时候，调用模糊查看本地音乐的功能：
mSearchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() { @Override
public boolean onQueryTextSubmit(String query) { //提交按钮的点击事件
Toast.makeText(SearchViewActivity.this, query, Toast.LENGTH_SHORT).show(); return true;
} @Override
public boolean onQueryTextChange(String newText) { //当输入框内容改变的时候回调
// Log.i(TAG,"内容: " + newText);
quertMusic(newText); return true;
}
}); /**
* 模糊查找音乐
* @param key
*/private void quertMusic(String key) {
String[] musics = new String[]{}; if (!TextUtils.isEmpty(key)){
musics = FileUtils.queryMusic(this, key);
}
ArrayAdapter<String> adapter = new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, musics);
mLvMusic.setAdapter(adapter);
}FileUtils中，查找本地音乐数据库的queryMusic()方法：
/**
* 根据歌名查看音乐
* @param context 上下文
* @param key 关键字
* @return
*/public static String[] queryMusic(Context context, String key) {
ArrayList<String> nameList = new ArrayList<>();
Cursor c = null; try {
c = context.getContentResolver().query(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, null,
MediaStore.Audio.Media.DISPLAY_NAME + " LIKE '%" + key + "%'", null,
MediaStore.Audio.Media.DEFAULT_SORT_ORDER); while (c.moveToNext()) {
String path = c.getString(c.getColumnIndexOrThrow(MediaStore.Audio.Media.DATA));// 路径
if (!FileUtils.isExists(path)) { continue;
}
String name = c.getString(c.getColumnIndexOrThrow(MediaStore.Audio.Media.DISPLAY_NAME)); // 歌曲名
nameList.add(name);
}
} catch (Exception e) {
e.printStackTrace();
} finally { if (c != null) {
c.close();
}
} if (nameList.isEmpty()){ return new String[]{};
} return (String[])nameList.toArray(new String[nameList.size()]);
}利用ContentResolver查找本地音乐数据库，这里只是简单查询出歌曲名，然后将歌曲的集合转换成数组，需要注意的是，如果是Android6.0以上，需要动态申请读取SD卡的权限：
@Overrideprotected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState);
supportRequestWindowFeature(Window.FEATURE_NO_TITLE);
setContentView(R.layout.activity_search_view);
initView();
initToolbar();
requestPermission();
}private void requestPermission() { if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED){ //如果还没有读取SD卡的权限,申请
ActivityCompat.requestPermissions(this,new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},REQ_PERMISSION);
}
}这里在初始化完毕的时候进行权限的判断和申请。
好的，到这里SearchView的相关用法已经介绍完毕了，需要源码的可以查看：