Pro Android学习笔记（五十）：ActionBar（3）：搜索条

ActionBar中的搜索条

我们同样可以在Action Bar中嵌入搜索条。在小例子中，我们在action bar中嵌入一个搜索框的widget（称为search view）。当我们输入搜索内容，能够在指定的activity中打开（称为searchable activitiy)，本例不做实质的搜索，只是在指定的activity中显示所要搜索的内容。

通过Menu item上定义search view

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android" >
    <item android:id="@+id/menu_search"
            android:title="Search"
            android:showAsAction="ifRoom" 
            android:actionViewClass="android.widget.SearchView"  />
     … 其他item 内容…

通过android:showAsAction表明这是在action bar上的菜单项，如果我们将属性设置为：android:showAsAction="collapseActionView|ifRoom" ，则如右图所示。collapseActionView允许将search view扩展到整个action bar中。对于手机而言，扩展输入框的长度，具有更好的用户体验。这种情况，不使用时，UI同普通的action bar菜单项一样，因此我们需要为之设立android:icon="@drawable/ic_search"来显示图标。

通过android:actionViewClass="android.widget.SearchView"我们将在此嵌入search view的widget，对应为SearchView类。

进行Searchable的配置

Search View可以看作为某个searchable activity在其他activity的action bar中显示的widget。通过这个widget，可以调用searchable activity。对search view的配置可以同res/xml/searchable.xml文件。更多的配置属性请参见：http://developer.android.com/guide/topics/search/searchable-config.html。本例内容如下：

<?xml version="1.0" encoding="utf-8"?>
<searchable xmlns:android="http://schemas.android.com/apk/res/android"
    android:label="@string/search_result" wei：必须包含android:label，一般与app或activity的label相同，但不一样也不影响效果 
    android:hint="@string/search_hint"     wei：一般建议提供hint，作为输入框的提示
/>

search view是searchable activity在其他activity的入口，它的配置是通过searchable activity进行设置，在AndroidManifest.xml中，相关片段如下。searchable activity必须是ACTION_SEARCH。

        <activity android:name=".SearchResultActvity" android:label="@string/search_result" >
            <intent-filter>
                <action android:name="android.intent.action.SEARCH"/>
            </intent-filter>
            <meta-data android:name="android.app.searchable" android:resource="@xml/searchable"/>
        </activity>

在activity中将search view关联searchable activity

在activity中加入search view和加入action bar，或者加入options menu没有区别，

public boolean onCreateOptionsMenu(Menu menu) {
    // 加入含有search view的菜单
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(menuId, menu);
    // 获取SearchView对象
    SearchView searchView = (SearchView) menu.findItem(R.id.menu_search).getActionView(); 
    if(searchView == null){ 
        Log.e("SearchView"，"Fail to get Search View.");
        return true;
    }
    searchView.setIconifiedByDefault(true); // 缺省值就是true，可能不专门进行设置，false和true的效果图如下，true的输入框更大
   
   // 获取搜索服务管理器 
    SearchManager searchManager = (SearchManager) getSystemService(Context.SEARCH_SERVICE); 
    // searchable activity的component name，由此系统可通过intent进行唤起
    ComponentName cn = new ComponentName(this,SearchResultActvity.class);
    // 通过搜索管理器，从searchable activity中获取相关搜索信息，就是searchable的xml设置。如果返回null，表示该activity不存在，或者不是searchable
    SearchableInfo info = searchManager.getSearchableInfo(cn);
    if(info == null){
        Log.e("SearchableInfo",Fail to get search info.");
    }     
    // 将searchable activity的搜索信息与search view关联
    searchView.setSearchableInfo(info);

    return true;
}

如果我们希望能获得系统全局的搜索，可以通过ComponentName cn = searchManager.getGlobalSearchActivity();来获取。可以通过List<SearchableInfo> list = searchManager.getSearchablesInGlobalSearch();来查看系统有效的全局搜索。

Searchable activity的代码

public class SearchResultActvity extends Activity{ 
    @Override
    protected void onCreate(Bundle savedInstanceState) { 
        … …       
        doSearchQuery(getIntent());
    }

    @Override
    protected void onNewIntent(Intent intent) {  //activity重新置顶
        super.onNewIntent(intent);
        doSearchQuery(intent);
    }

    // 对searchable activity的调用仍是标准的intent，我们可以从intent中获取信息，即要搜索的内容
    private void doSearchQuery(Intent intent){ 
        if(intent == null)
            return;

        String queryAction = intent.getAction();
        if( Intent.ACTION_SEARCH.equals( intent.getAction())){  //如果是通过ACTION_SEARCH来调用，即如果通过搜索调用
            String queryString = intent.getStringExtra(SearchManager.QUERY); //获取搜索内容
            … …  
        } 
        
    } 
    … …
}

相关参考见：http://developer.android.com/training/search/setup.html

本博文涉及的例子代码，可以在Pro Android学习：ActionBar小例子中下载。

相关链接： 我的Android开发相关文章