一、简介
SearchView 是和 Toolbar 联动,通过 menu 进行设置的搜索的控件(不知道我这么概括你能不能懂)。会在 Toolbar
的右侧出现一个搜索的按钮(系统自带的,也可以进行替换)。当你点击搜索按钮的时候,会出现相应的编辑框进行搜索。当你点击叉号的时候,本次搜索取消,还原成搜索按钮。
二、属性
-
输入类型
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));
三、代码实践
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>
2. 重写 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;
}
});