Searchable(搜索功能)（转）

文章来源：http://developer.android.com/guide/topics/search/search-dialog.html

一、前言：

Android为程序的搜索功能提供了统一的搜索接口，search dialog和search widget。

search dialog只能为于activity窗口的上方，search widget可以位于任何位置。

search dialog和search widget都会向我们的searchable activity发送消息（主要是搜索关键字）。

通过这种方式，可以为任何activity加入search dialog和search widget,系统可以启动合适的activity来处理搜索并显示结果。

search dialog和search widget的其他属性如下：

A：声音搜索。

B：根据最近的搜索结果，给出搜索建议。

C：根据我们程序的实际搜索结果，给出搜索建议。

注1：search widget在 Android 3.0或更高版本才可用

注2：searchable activity才是真正执行搜索的。

二、基本知识

在开始实现搜索功能之前，请决定使用search dialog，还是search widget.

他们的搜索功能特性都有一样，但是他们还有微小区别。

A,search dialog是一个被系统控制的UI组件。但他被用户激活的时候，它总是出现在activity的上方，如图一所示。

B,Android系统负责处理search dialog上所有的事件，当用户提交了查询，系统会把这个查询请求传输到我们的searchable activity，

让searchable activity在处理真正的查询。当用户在输入的时候，search dialog还能提供搜索建议。

C,search widget是SearchView的一个实例，你可以把它放在你的布局的任何地方。

D,默认的，search widget和一个标准的EditText widget一样，不能做任何事情。

但是你可以配置它，让android系统处理所有的按键事件，把查询请求传输给合适的activity,可以配置它让它像search dialog一样提供search suggestions。

E,search widget在 Android 3.0或更高版本才可用. search dialog没有此项限制

提示: 如果你想自己在search widget处理所有的用户输入，请使用各种回调函数和监听接口，具体参照SearchView 。

图一：

当用户在search dialog或search widget中执行一个搜索的时候，系统会创建一个Intent，并把查询关键字保存在里面，

然后启动我们在AndroidManifest.xml中声明好的searchable activity，并把Intent传送给它。

实现一个可以搜索的程序，主要需要以下几个部份：

（1），search dialog or widget的配置文件。

配置一个XML文件用于配置search dialog 或widget的设置。对于search dialog，该配置文件的名字一般约定为searchable.xml

（2），searchable activity。

searchable activity用于接收搜索关键字，并进行数据搜索和显示搜索结果。

（3），搜索条。search dialog 或search widget

    * The search dialog

      默认的,search dialog是隐藏。当我们按下了SEARCH键或在程序中调用onSearchRequested()，它将出现在屏幕的上方.

    * a SearchView widget

使用search widget的时候，你可以把该搜索条放在我们activity的任何地方。

Instead of putting it in your activity layout, however, it's usually more convenient for users as an action view in the Action Bar.

三、创建配置文件searchable.xml

配置文件说明了search dialog 或widget的一些属性。包括UI，以及suggestions 和voice search behave的一些属性。

该文件一般约定为searchable.xml并位于res/xml/目录下。

searchable.xml必须以<searchable> element 作为根节点，且至少定义一个属性。

比如，示例1:

<?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>

android:label是唯一必须定义的属性。它指向一个字符串，它应该是应用程序的名字。

实际上该label也只有在search suggestions for Quick Search Box可用时才可见。

这时该label在系统设置的Searchable项的列表中可见。

虽然android:hint属性不是必须，但是还是推介总是定义它。它是search box用户输入前输入框中的提示语。

<searchable> 还有其他的一些属性。如果不需要search suggestions 和voice search的话，大多数的属性是不需要的。

关于searchable.xml更多内容请参考：http://developer.android.com/guide/topics/search/searchable-config.html