创建搜索界面
Android提供个两个方法用于创建搜索界面:
- 搜索对话框:一个由Android System控制的UI组件,并由用户配置激活显示在Activity的顶部。Android系统控制对话框中的所有事件。
- 搜索组件:是SearchView的一个实例,它的行为类似EditText,可以放置在界面任何地方,需要对它进行配置以让Android系统进行处理事件。Google建议将之放置ActionBar中。当然,开发者也可以通过SearchView里的回调方法和监听器去处理用户事件。
由此可见,使用SearchView会更加灵活。
相同之处,两者都要对SearchableInfo进行配置。
不同之处为,搜索对话框需要调用activity的onSearchRequested()激活显示。而SearchView则需要默认显示,只须决定其初始的显示状态为展开或闭合。
配置
当用户在搜索框或用搜索组件执行了一个搜索,系统创建了一个附带了用户查询词的Intent,并启动activity去处理搜索。为了满足以上要求,需要以下东西:
- 搜索配置:一个XML文件searchable.xml,可以配置语音搜索、搜索建议和提示词。
- 在manifest.xml中配置一个用于执行搜索并显示结果的Activity
- 一个搜索入口:搜索对话框或搜索组件
创建searchable.xml
- 创建路径:res/xml
- 对语音搜索,搜索建议和提示词进行配置
例子如下:
<?xml version="1.0" encoding="utf-8"?>
<searchable xmlns:android="http://schemas.android.com/apk/res/android"
android:label="@string/app_label"
android:hint="@string/search_hint" >
</searchable>
创建一个Searchable Activity
Searchable Activity用于执行搜索并显示结果。当用户在搜索框或搜索组件上开始搜索时,该Searchable Activity会收到一个附带搜索词而且类型为ACTION_SEARCH的Intent.为达到该目的,开发者需要在manifest.xml中对Searchable Activity进行指定,如下,其中ActivityWithDialog就是用于搜索的Activity。
<activity
android:name=".searchsample.ActivityWithDialog"
android:label="@string/title_activity_activity_with_dialog"
android:launchMode="singleTop"
android:theme="@style/AppTheme.NoActionBar">
<intent-filter>
<action android:name="android.intent.action.SEARCH" />
</intent-filter>
<meta-data
android:name="android.app.searchable"
android:resource="@xml/searchable" />
<meta-data android:name="android.app.default_searchable"
android:value=".searchsample.MainSearchActivity"/>
</activity>
注意,搜索框或搜索组件所在的Activity,也可以用于执行搜索和显示搜索结果,即输入搜索词的Activity和基于搜索词进行搜索和显示的Activity可以是同一个Activity。上面的例子就是这种情况。
但是,两种方式的处理方法有所不同:
- 用一个Activity时,需要重写Activity的onNewIntent()方法,并在manifest.xml种设置activity的lauchMode为singleTop.
- 用两个Activity时,只须在被启动的activity中的onCreate()方法中使用getIntent()获得前一个activity的传递过来的附带查询词的intent.
执行搜索
- 接收带搜索词的Intent
- 搜索
1 本地搜索
2 云端搜索
search dialog对activity声明周期的影响
搜索对话框弹出后,activity只是失去焦点,onPause()并不会被调用。
注:本篇文章主要在阅读完官方文档后的一个小结,后面会继续探索Search方面的使用。