SearchView使用详解

yechaoa

发布于 2022-06-10 12:52:39

1.7K0

文章被收录于专栏：移动开发专栏移动开发专栏

搜索在一般APP中是基本功能，且非常重要。常见的有组装的EditText，今天主要讲的是SearchView。

官方文档地址：https://developer.android.google.cn/reference/android/widget/SearchView

效果图：

很简单，主要3个步骤

创建菜单文件
配置SearchView
处理事件，即监听

1.创建菜单文件

在res文件夹下新建menu文件夹，然后在menu文件夹下新建menu_search.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:icon="@drawable/ic_menu_search"
        android:title="@string/search"
        app:actionViewClass="android.support.v7.widget.SearchView"
        app:showAsAction="ifRoom" />

    <item
        android:id="@+id/action_settings"
        android:orderInCategory="100"
        android:title="@string/action_settings"
        app:showAsAction="never"/>
</menu>

这里主要是app:actionViewClass 属性，就是告诉toolbar这是SearchView。

2.配置SearchView

这一步也很简单，只要知道相关属性就ok。

输入类型 android:inputType
最大宽度 android:maxWidth
搜索图标是否显示在搜索框内 mSearchView.setIconifiedByDefault(true);
设置搜索框展开时是否显示提交按钮，可不显示 mSearchView.setSubmitButtonEnabled(true);
让键盘的回车键设置成搜索 mSearchView.setImeOptions(EditorInfo.IME_ACTION_SEARCH);
搜索框是否展开，false表示展开 mSearchView.setIconified(false);
获取焦点 mSearchView.setFocusable(true); mSearchView.requestFocusFromTouch();
设置提示词 mSearchView.setQueryHint(“请输入关键字”);
设置输入框文字颜色 EditText editText = (EditText) mSearchView.findViewById(android.support.v7.appcompat.R.id.search_src_text); editText.setHintTextColor(ContextCompat.getColor(this, R.color.white)); editText.setTextColor(ContextCompat.getColor(this, R.color.white));

重写Activity的onCreateOptionsMenu(Menu menu) 方法：

	@Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        //引用menu文件
        getMenuInflater().inflate(R.menu.menu_search, menu);

        //找到SearchView并配置相关参数
        MenuItem searchItem = menu.findItem(R.id.action_search);
        SearchView mSearchView = (SearchView) MenuItemCompat.getActionView(searchItem);

        //搜索图标是否显示在搜索框内
        mSearchView.setIconifiedByDefault(true);
        //设置搜索框展开时是否显示提交按钮，可不显示
        mSearchView.setSubmitButtonEnabled(true);
        //让键盘的回车键设置成搜索
        mSearchView.setImeOptions(EditorInfo.IME_ACTION_SEARCH);
        //搜索框是否展开，false表示展开
        mSearchView.setIconified(false);
        //获取焦点
        mSearchView.setFocusable(true);
        mSearchView.requestFocusFromTouch();
        //设置提示词
        mSearchView.setQueryHint("请输入关键字");
        //设置输入框文字颜色
        EditText editText = (EditText) mSearchView.findViewById(android.support.v7.appcompat.R.id.search_src_text);
        editText.setHintTextColor(ContextCompat.getColor(this, R.color.white));
        editText.setTextColor(ContextCompat.getColor(this, R.color.white));

3.设置监听

主要是setOnQueryTextListener，包含搜索和内容发生改变两个事件。其他还有setOnCloseListener 关闭的监听，setOnSearchClickListener 点击搜索按钮的监听， setOnSuggestionListener 提示内容被选中的监听

        // 设置搜索文本监听
        mSearchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
            // 当点击搜索按钮时触发该方法
            @Override
            public boolean onQueryTextSubmit(String query) {
                Snackbar.make(mConstraintLayout, "搜索内容===" + query, Snackbar.LENGTH_SHORT).show();

                //伪搜索
                mSearchResult.setVisibility(View.VISIBLE);

                //清除焦点，收软键盘
                //mSearchView.clearFocus();

                return false;
            }

            // 当搜索内容改变时触发该方法
            @Override
            public boolean onQueryTextChange(String newText) {
                //do something
                //当没有输入任何内容的时候清除结果，看实际需求
                if (TextUtils.isEmpty(newText)) mSearchResult.setVisibility(View.INVISIBLE);
                return false;
            }
        });