Android SearchView使用详解及示例源码
一、概述
SearchView是google提供的搜索框视图控件，可以和menu、ToolBar结合一块使用，用来实现头部搜索框。本文主要讲解的内容及效果： 源码地址
二、SearchView一般应用
1、menu目录下增加菜单项
SearchView是结合menu加入到ToolBar上的，所以要增加菜单项。这里我们在menu目录下增加menu_searchview.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/magnify"
android
:title=
"action_search"
app
:actionViewClass=
"android.support.v7.widget.SearchView"
app
:showAsAction=
"always|collapseActionView"
/>
menu
>
注意这里
actionViewClass是一般菜单项目没有的，
actionViewClass前的app指明我们的Activity基类为
AppCompatActivity。
2、ToolBar替换ActionBar
对ToolBar的使用和详细介绍可以参考 Android ToolBar使用详解及示例源码文章，这里就不详细介绍了。如果不用ToolBar替换ActionBar下边的菜单项加载也是可以的。
3、菜单项加载
在Activity加载菜单项是通过重写
onCreateOptionsMenu(Menu menu)方法进行的，通过该方法可以得到Menu对象，而SearchView是Menu中item的一个actionView，actionView可以通过MenuItemCompat获取，所以通过Menu对象可以得到SearchView。这样最基本的SearchView已经可以运行展示。
@Override
public boolean
onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.
menu_searchview
, menu);
return super
.onCreateOptionsMenu(menu);
}
三、SearchView基本属性设置
1、一些基本设置
//搜索框内显示搜索图标，默认是不显示的
searchView
.setIconifiedByDefault(
false
);
//改变输入框内提示文字
TextView textView = (TextView)searchView
.findViewById(android.support.v7.appcompat.R.id.search_src_text);
//注意这里是用的setHint不是setText
textView.setHint(
"输入搜索内容"
);
//设置最右侧的提交按钮
searchView
.setSubmitButtonEnabled(
true
);
//也可以改变输入框内提示文字
searchView
.setQueryHint(
"输入搜索
内容
"
);
//默认展开搜索框
searchView.onActionViewExpanded();
2、获取SearchView内的基本组件
获取组件后可以通过组件进行自定义的样式修改，比如更换图标。
//
//输入框文字
(
TextView
) findViewById(R.id.search_src_text);
//右侧提交按钮
(ImageView) findViewById(R.id.search_go_btn);
//右侧关闭按钮(输入文字后出现的x)
(ImageView) findViewById(R.id.search_close_btn);
//语音输入按钮
(ImageView) findViewById(R.id.search_voice_btn);
//输入框内Icon
(ImageView) findViewById(R.id.search_mag_icon);
四、SearchView常用事件
1、展开、收缩监听事件
代码在onCreateOptionsMenu(Menu menu)方法中
MenuItem menuItem=menu.findItem(R.id.
action_search
);
//SearchView searchView = (SearchView) MenuItemCompat.getActionView(menuItem);
MenuItemCompat.
setOnActionExpandListener
(menuItem,
new
MenuItemCompat.OnActionExpandListener() {
@Override
public boolean
onMenuItemActionExpand(MenuItem item) {
Toast.
makeText
(MainActivity.
this
,
"案秀云Expand!"
, Toast.
LENGTH_SHORT
).show();
return true
;
}
@Override
public boolean
onMenuItemActionCollapse(MenuItem item) {
Toast.
makeText
(MainActivity.
this
,
"案秀云 Collapse!"
, Toast.
LENGTH_SHORT
).show();
return true
;
}
});
2、输入框文字提交和变化事件
也是在
onCreateOptionsMenu(Menu menu)方法中执行
searchView
.setOnQueryTextListener(
new
SearchView.OnQueryTextListener() {
@Override
public boolean
onQueryTextSubmit(String query) {
Toast.
makeText
(MainActivity.
this
,
"提交内容-"
+ query, Toast.
LENGTH_SHORT
).show();
return true
;
}
@Override
public boolean
onQueryTextChange(String newText) {
Toast.
makeText
(MainActivity.
this
,
"输入变化-"
+ newText, Toast.
LENGTH_SHORT
).show();
return true
;
}
});