【轉】 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開發相關文章

【轉】 Pro Android學習筆記（五十）：ActionBar（3）：搜尋條