MaterialDesign学习篇(五)，使用SearchView的正确姿势

介绍

大多APP都具有搜索功能，但是大部分都是在标题栏中放置搜索的图标或者是不可输入的EditText，当点击的时候，开启另外一个界面进行搜索，但是网易云音乐在搜索本地音乐的时候，点击搜索按钮，就会出现输入框，点击返回时，又会再次收起，以前认为需要自己根据状态做布局的改变，最后发现原来有一个很方便好用的控件，叫做SearchView，现在开始学习下如何使用SearchView。

网易云音乐的效果如下：

使用SearchView

SearchView需要和Toolbar一起使用，如果不熟悉Toolbar的使用，可以查看我写过的介绍Toolbar的文章：

MaterialDesign学习篇(二)，Toolbar、DrawerLayout的使用

创建带SearchView的menu

在res->menu文件夹中我们新建一个叫做menu_search_view.xml的文件，文件的内容为：

其中第一个是搜索的条目，我们指定了它的actionViewClass=“android.support.v7.widget.SearchView”，这就表明它是一个SearchView，和其他的菜单条目不同，下面会给大家演示它的不同之处。

布局文件中使用Toolbar

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菜单项图标的颜色:

只需要设置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的主题中进行修改：

可以看到搜索图标变成自己指定的图标了，无论是展开还是收起状态，图标都改变了.

修改输入框文字提示的颜色和内容文字的颜色

 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));//设置内容文字颜色

可以看到，提示文字的颜色和内容文字的颜色都变成白色了。

去除搜索框中的图标

指定SearchView样式中的searchHintIcon为null,即可去除搜索框中的图标，如图：

关联navigationIcon的点击

这里我们尝试做成跟网易云音乐一样，当搜索框处于展开的时候，点击返回键是收起SearchView,当SearchView处于收起时，点击是关闭当前Activity。

修改布局文件中的Toolbar,指定navigationIcon:

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的样式:

在布局文件中，引用Toolbar的样式：

Toolbar的样式中，我们修改了navigationIcon和title之间的距离，将其修改为0，现在看起来navigationIcon和SearchView之间的距离是不是变小了，好看些了。

模仿网易云音乐搜索本地音乐功能

先看下效果:

修改布局文件，即Toolbar + ListView：

当搜索内容变化的时候，调用模糊查看本地音乐的功能：

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 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 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卡的权限：

 @Override
protected 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的相关用法已经介绍完毕了，需要源码的可以查看：

https://github.com/chaychan/MaterialDesignExercise

下一篇将为大家介绍调色板Palette，感兴趣的朋友可以继续查看：

MaterialDesign学习篇(六)，调色板Palette的学习