新聞中心
最近向開發(fā)者介紹過Android開發(fā)之WebView組件的使用詳解,今天我們?cè)賮斫榻B一下Android系統(tǒng)搜索對(duì)話框設(shè)計(jì)使用方法:

當(dāng)您需要在您的應(yīng)用程序中提供搜索服務(wù)時(shí),您第一個(gè)想到的是您的搜索框要放哪呢?通過使用Android的搜索框架,應(yīng)用程序?qū)@示一個(gè)自定義搜索對(duì)話框來處理用戶的搜索請(qǐng)求。通過一個(gè)簡單的搜索按鈕或從您的應(yīng)用程序中調(diào)用API,搜索對(duì)話框就會(huì)顯示在屏幕的頂部,并會(huì)自動(dòng)顯示您的應(yīng)用程序圖標(biāo)。如下圖所示:
搜索框
本文將教你如何為你的應(yīng)用程序提供一個(gè)自定義搜索對(duì)話框。這樣做,給您的用戶提供一個(gè)標(biāo)準(zhǔn)化的搜索體驗(yàn),并能增加如語音搜索和搜索建議等功能。
基礎(chǔ)知識(shí)
Android的搜索框架將代您管理的搜索對(duì)話框,您不需要自己去開發(fā)一個(gè)搜索框,不需要擔(dān)心要把搜索框放什么位置,也不需要擔(dān)心搜索框影響您當(dāng)前的界面。所有的這些工作都由SearchManager類來為您處理(以下簡稱“搜索管理器”),它管理的Android搜索對(duì)話框的整個(gè)生命周期,并執(zhí)行您的應(yīng)用程序?qū)l(fā)送的搜索請(qǐng)求,返回相應(yīng)的搜索關(guān)鍵字。
當(dāng)用戶執(zhí)行一個(gè)搜索,搜索管理器將使用一個(gè)專門的Intent把搜索查詢的關(guān)鍵字傳給您在配置文件中配置的處理搜索結(jié)果的Activity。從本質(zhì)上講,所有你需要的就是一個(gè)Activity來接收Intent,然后執(zhí)行搜索,并給出結(jié)果。具體來說,你需要的做的事就包括以下內(nèi)容:
一個(gè)搜索配置
我們用個(gè)XML配置文件來對(duì)搜索對(duì)話框進(jìn)行配置,包括一些功能的配置,如文本框,設(shè)置語音搜索和搜索建議中顯示的提示文字等。
一個(gè)用來處理搜索請(qǐng)求的Activity
這個(gè)Activity用來接收搜索查詢的內(nèi)容,然后搜索您的數(shù)據(jù)并顯示搜索結(jié)果。
一種用戶執(zhí)行搜索的途徑
默認(rèn)情況下,一旦你配置了一個(gè)可搜索的Activity,設(shè)備搜索鍵(如果有)將調(diào)用搜索對(duì)話框。然而,你應(yīng)該始終提供另一種手段,讓用戶可以調(diào)用搜索對(duì)話框,如在選項(xiàng)菜單中的搜索按鈕或其他用戶界面上的按鈕,因?yàn)椴皇撬械脑O(shè)備提供一個(gè)專門的搜索鍵。
創(chuàng)建一個(gè)搜索對(duì)話框配置文件
搜索框配置文件是一個(gè)用來配置您的應(yīng)用程序中搜索框的設(shè)置的XML文件,這個(gè)文件一般命名為searchable.xml,并且必須保存在項(xiàng)目的res/xml/目錄下。
配置文件的根節(jié)點(diǎn)必須為,可以有一個(gè)或多個(gè)屬性。如下圖所示:
- xml version="1.0" encoding="utf-8"?>
- android:label="@string/searchLabel" android:hint="@string/searchHint">
- searchable>
上面的配置文件中,除android:hint屬性外,其它都是一個(gè)搜索對(duì)話框必須的配置項(xiàng),android:label是一個(gè)必須的屬性,它的值為一個(gè)string資源引用,不能直接用字符串,通常會(huì)是應(yīng)用程序的名稱(盡管它是一個(gè)必須的屬性,但通常情況下是不顯示出來的,除非你開啟了搜索建議功能)。android:hint是配置搜索框的輸入提示信息,也必須引用string.xml中配置的字符串資源,不能直接使用字符串。
可以配置很多的屬性,但大部分屬性都只是在使用搜索建議和語音搜索時(shí)進(jìn)行配置,盡管如此,我們建議你一定要配置android:hint,用于提示用戶需要輸入的信息。
接下來,你需要把這個(gè)配置文件放到你的應(yīng)用程序中。
創(chuàng)建一個(gè)可用于搜索的Activity
當(dāng)用戶從一個(gè)搜索框執(zhí)行搜索時(shí),搜索管理器(Search Manager)會(huì)通過ACTION_SEARCH Intent 把要搜索的內(nèi)容(關(guān)鍵字)發(fā)送到一個(gè)可執(zhí)行搜索的Activity。這個(gè)Acitivity查詢數(shù)據(jù)并顯示結(jié)果。
定義一個(gè)可搜索的Activity
如果你還沒有準(zhǔn)備好,那么就創(chuàng)建一個(gè)用來執(zhí)行搜索的Activity,聲明它可以響應(yīng)ACTION_SEARCH Intent ,并且增加搜索框配置信息。為此,你需要添加一個(gè)元素和一個(gè)元素在你的manifest文件中的節(jié)點(diǎn)。如下所示:
- intent-filter>
- android:resource="@xml/searchable"/>
- activity>
- ...
- application>
中的android:name屬性值必須為”android.app.searchable”,android:resource屬性值必須引用上面提到的res/xml/目錄下的搜索配置文件(本例中的res/xml/searchable.xml)。
請(qǐng)注意,只有配置了上面的meta-data節(jié)點(diǎn)的Activity的節(jié)點(diǎn)才能執(zhí)行搜索,如果想在整個(gè)應(yīng)用程序中都可以調(diào)用搜索框,可以進(jìn)行如下配置:
- intent-filter>
- android:resource="@xml/searchable"/>
- activity>
- activity>
- >
- android:value=".MySearchableActivity" />
- ...
- application>
上面代碼中android:name=”android.app.default_searchable” 定義一個(gè)響應(yīng)搜索框搜索請(qǐng)求的名稱,android:value指定是由哪個(gè)Activity響應(yīng)并執(zhí)行搜索。當(dāng)我們?cè)趹?yīng)用程序中的OtherAcitivity中執(zhí)行搜索請(qǐng)求時(shí),MySearchableActivity將會(huì)被加載用于執(zhí)行搜索并顯示搜索結(jié)果。
執(zhí)行一個(gè)搜索
當(dāng)一個(gè)Activity聲明為可搜索時(shí),執(zhí)行實(shí)際的搜索包括三個(gè)步驟:接收查詢,檢索你的數(shù)據(jù),并提交結(jié)果。
通常情況下,你的搜索結(jié)果需要在一個(gè)ListView中展現(xiàn),所以你用于執(zhí)行搜索的Acitivity要繼承ListActivity,這樣,可以方便的訪問ListView的Api。
接收搜索查詢
當(dāng)從搜索對(duì)話框執(zhí)行搜索時(shí),剛才配置的可用于搜索的Acitivity將會(huì)被Intent激活,同時(shí)帶著一些搜索相關(guān)的參數(shù),你需要檢查Intent并做出搜索響應(yīng),如下所示:
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.search);
- Intent intent = getIntent();
- //判斷是否是搜索請(qǐng)求
- if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
- //獲取搜索的查詢內(nèi)容(關(guān)鍵字)
- String query = intent.getStringExtra(SearchManager.QUERY);
- //執(zhí)行相應(yīng)的查詢動(dòng)作
- doMySearch(query);
- }
- }
doMySearch()方法將根據(jù)關(guān)鍵字查詢數(shù)據(jù)庫,或從網(wǎng)絡(luò)上查詢數(shù)據(jù),如果是耗時(shí)的搜索,你還需要使用進(jìn)度條,來告訴用戶搜索正在進(jìn)行,最后返回結(jié)果后,可以調(diào)用ListView的setAdapter()方法將結(jié)果顯示在ListView中。
調(diào)用搜索對(duì)話框
你可以從應(yīng)用程序中的任何一個(gè)地方調(diào)用onSearchRequested()方法激活搜索框,比如從菜單中或者一個(gè)按鈕等。你也要以在onCreate()方法中調(diào)用setDefaultKeyMode(DEFAULT_KEYS_SEARCH_LOCAL),這樣,當(dāng)用戶按下鍵盤上的按鍵時(shí),將會(huì)自動(dòng)激活搜索框。
搜索框和普通對(duì)話框一樣,浮動(dòng)在屏幕的最上方,它不會(huì)改變?nèi)魏蜛ctivity堆棧狀態(tài),沒有任何Activity生命周期中的方法會(huì)被調(diào)用,只是當(dāng)搜索框出現(xiàn)就,正在運(yùn)行的Activity會(huì)失去輸入焦點(diǎn)。
如果你要在執(zhí)行搜索時(shí),進(jìn)行別的操作,可以重寫onSearchRequested()方法,如下所示:
- @Override
- public boolean onSearchRequested() {
- //這個(gè)方法中干你想干的事,比如做一些被始化工作
- pauseSomeStuff();
- return super.onSearchRequested();
- }
如果當(dāng)前的Activity就是響應(yīng)搜索請(qǐng)求的Activity時(shí),會(huì)有以下兩種情況:
默認(rèn)情況下,ACTION_SEARCH Intent將會(huì)創(chuàng)建一個(gè)新的Activity,并調(diào)用onCreate()方法,這個(gè)新的Activity會(huì)顯示在最前面,你將同時(shí)有兩個(gè)Activity實(shí)例。當(dāng)你按“返回”鍵里,會(huì)回到?jīng)]有執(zhí)行搜索前的一個(gè)Activity。
另一種情況是配置了android:launchMode=”singleTop”的Activity,這時(shí),我們需要在onNewIntent(Intent)方法中處理搜索請(qǐng)求,如下所示:
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.search);
- handleIntent(getIntent());
- }
- @Override
- protected void onNewIntent(Intent intent) {
- setIntent(intent);
- handleIntent(intent);
- }
- private void handleIntent(Intent intent) {
- if (Intent.ACTION_SEARCH.equals(intent.getAction())) {
- String query = intent.getStringExtra(SearchManager.QUERY);
- doMySearch(query);
- }
- }
相應(yīng)的Activity配置如下
- android:launchMode="singleTop" >
- intent-filter>
- android:resource="@xml/searchable"/>
- activity>
如何給搜索框增加參數(shù)
要給搜索框傳遞參數(shù),我們需要重寫onSearchRequested()方法,如下所示:
- @Override
- public boolean onSearchRequested() {
- Bundle appData = new Bundle();
- appData.putBoolean(MySearchableActivity.JARGON, true);
- startSearch(null, false, appData, false);
- return true;
- }
我們的Activity在收到搜索框的搜索請(qǐng)求時(shí),通過如下方法獲取參數(shù):
- Bundle appData = getIntent().getBundleExtra(SearchManager.APP_DATA);
- if (appData != null) {
- boolean jargon = appData.getBoolean(MySearchableActivity.JARGON);
- }
最后我們來看看如何使用android的語音搜索:
只需要對(duì)我們的搜索配置文件做如下改動(dòng),你的搜索就支持語音搜索了,配置文件如下所示:
- xml version="1.0" encoding="utf-8"?>
- android:label="@string/searchLabel"
- android:hint="@string/searchHint"
- android:voiceSearchMode="showVoiceSearchButton|launchRecognizer">
- searchable>
好了,今天就到這兒,自己動(dòng)手練習(xí)去吧!以后還會(huì)詳細(xì)講解如何增加搜索建議,語音搜索等內(nèi)容。
示例程序下載:http://www.ideasandroid.com/android/demo/FloatSearchBoxDemo.rar
原文地址:http://www.ideasandroid.com/?p=310
【編輯推薦】
- Android開發(fā)之WebView組件的使用詳解
- Android開發(fā)中的窗口小部件App Widgets
- 最新最好的Android開發(fā)類說明
- 對(duì)Android開發(fā)技巧進(jìn)行全解析
文章名稱:Android系統(tǒng)搜索對(duì)話框設(shè)計(jì)妙招
本文地址:http://fisionsoft.com.cn/article/codppss.html


咨詢
建站咨詢
