1. 程式人生 > >Pro Android學習筆記(五十):ActionBar(3):搜尋條

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); //獲取搜尋內容
            … …  
        } 
        
    } 
    … …
}