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

目录(?)[-]

1. ActionBar中的搜索条
2. 通过Menu item上定义search view
3. 进行Searchable的配置
4. 在activity中将search view关联searchable activity
5. Searchable activity的代码

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开发相关文章