編寫:Vincent 4J - 原文:http://developer.android.com/training/basics/actionbar/adding-buttons.html
Action bar 允許我們?yōu)楫?dāng)前環(huán)境下最重要的操作添加按鈕。那些直接出現(xiàn)在 action bar 中的 icon 和/或文本被稱作action buttons(操作按鈕)。安排不下的或不足夠重要的操作被隱藏在 action overflow (超出空間的action,譯者注)中。
http://wiki.jikexueyuan.com/project/android-training-geek/images/actionbar-actions.png" alt="actionbar-actions" />
圖 1. 一個有search操作按鈕和 action overflow 的 action bar,在 action overflow 里能展現(xiàn)額外的操作。
所有的操作按鈕和 action overflow 中其他可用的條目都被定義在 menu資源 的 XML 文件中。通過在項目的 res/menu
目錄中新增一個 XML 文件來為 action bar 添加操作。
為想要添加到 action bar 中的每個條目添加一個 <item>
元素。例如:
res/menu/main_activity_actions.xml
<menu xmlns:android="http://schemas.android.com/apk/res/android" >
<!-- 搜索, 應(yīng)該作為動作按鈕展示-->
<item android:id="@+id/action_search"
android:icon="@drawable/ic_action_search"
android:title="@string/action_search"
android:showAsAction="ifRoom" />
<!-- 設(shè)置, 在溢出菜單中展示 -->
<item android:id="@+id/action_settings"
android:title="@string/action_settings"
android:showAsAction="never" />
</menu>
上述代碼聲明,當(dāng) action bar 有可用空間時,搜索操作將作為一個操作按鈕來顯示,但設(shè)置操作將一直只在 action overflow 中顯示。(默認(rèn)情況下,所有的操作都顯示在 action overflow 中,但為每一個操作指明設(shè)計意圖是很好的做法。)
icon 屬性要求每張圖片提供一個 resource ID
。在 @drawable/
之后的名字必須是存儲在項目目錄 res/drawable/
下位圖圖片的文件名。例如:ic_action_search.png
對應(yīng) "@drawable/ic_action_search"。同樣地,title 屬性使用通過 XML 文件定義在項目目錄 res/values/
中的一個 string 資源
,詳情請參見 創(chuàng)建一個簡單的 UI 。
注意:當(dāng)創(chuàng)建 icon 和其他 bitmap 圖片時,要為不同屏幕密度下的顯示效果提供多個優(yōu)化的版本,這一點很重要。在 支持不同屏幕 課程中將會更詳細地討論。
如果為了兼容 Android 2.1 的版本使用了 Support 庫,在 android
命名空間下 showAsAction
屬性是不可用的。Support 庫會提供替代它的屬性,我們必須聲明自己的 XML 命名空間,并且使用該命名空間作為屬性前綴。(一個自定義 XML 命名空間需要以我們的 app 名稱為基礎(chǔ),但是可以取任何想要的名稱,它的作用域僅僅在我們聲明的文件之內(nèi)。)例如:
res/menu/main_activity_actions.xml
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:yourapp="http://schemas.android.com/apk/res-auto" >
<!-- 搜索, 應(yīng)該展示為動作按鈕 -->
<item android:id="@+id/action_search"
android:icon="@drawable/ic_action_search"
android:title="@string/action_search"
yourapp:showAsAction="ifRoom" />
...
</menu>
要為 action bar 布局菜單條目,就要在 activity 中實現(xiàn) onCreateOptionsMenu() 回調(diào)方法來 inflate
菜單資源從而獲取 Menu 對象。例如:
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// 為ActionBar擴展菜單項
MenuInflater inflater = getMenuInflater();
inflater.inflate(R.menu.main_activity_actions, menu);
return super.onCreateOptionsMenu(menu);
}
當(dāng)用戶按下某一個操作按鈕或者 action overflow 中的其他條目,系統(tǒng)將調(diào)用 activity 中onOptionsItemSelected()的回調(diào)方法。在該方法的實現(xiàn)里面調(diào)用MenuItem的getItemId()來判斷哪個條目被按下 - 返回的 ID 會匹配我們聲明對應(yīng)的 <item>
元素中 android:id
屬性的值。
@Override
public boolean onOptionsItemSelected(MenuItem item) {
// 處理動作按鈕的點擊事件
switch (item.getItemId()) {
case R.id.action_search:
openSearch();
return true;
case R.id.action_settings:
openSettings();
return true;
default:
return super.onOptionsItemSelected(item);
}
}
在不是程序入口的其他所有屏中(activity 不位于主屏?xí)r),需要在 action bar 中為用戶提供一個導(dǎo)航到邏輯父屏的up button(向上按鈕)。
http://wiki.jikexueyuan.com/project/android-training-geek/images/actionbar-up.png" alt="actionbar-up.png" />
圖 2. Gmail 中的 up button。
當(dāng)運行在 Android 4.1(API level 16) 或更高版本,或者使用 Support 庫中的 ActionBarActivity 時,實現(xiàn)向上導(dǎo)航需要在 manifest 文件中聲明父 activity ,同時在 action bar 中設(shè)置向上按鈕可用。
如何在 manifest 中聲明一個 activity 的父類,例如:
<application ... >
...
<!-- 主 main/home 活動 (沒有上級活動) -->
<activity
android:name="com.example.myfirstapp.MainActivity" ...>
...
</activity>
<!-- 主活動的一個子活動-->
<activity
android:name="com.example.myfirstapp.DisplayMessageActivity"
android:label="@string/title_activity_display_message"
android:parentActivityName="com.example.myfirstapp.MainActivity" >
<!-- meta-data 用于支持 support 4.0 以及以下來指明上級活動 -->
<meta-data
android:name="android.support.PARENT_ACTIVITY"
android:value="com.example.myfirstapp.MainActivity" />
</activity>
</application>
然后,通過調(diào)用setDisplayHomeAsUpEnabled() 來把 app icon 設(shè)置成可用的向上按鈕:
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_displaymessage);
getSupportActionBar().setDisplayHomeAsUpEnabled(true);
// 如果你的minSdkVersion屬性是11活更高, 應(yīng)該這么用:
// getActionBar().setDisplayHomeAsUpEnabled(true);
}
由于系統(tǒng)已經(jīng)知道 MainActivity
是 DisplayMessageActivity
的父 activity,當(dāng)用戶按下向上按鈕時,系統(tǒng)會導(dǎo)航到恰當(dāng)?shù)母?activity - 你不需要去處理向上按鈕的事件。
更多關(guān)于向上導(dǎo)航的信息,請見 提供向上導(dǎo)航。