本文翻译了这篇文章:Using the Android action bar (ActionBar) - Tutorial

1、ActionBar的简介
ActionBar位于Activity的顶部,可用来显示activity的标题、Icon、Actions和一些用于交互的View。它也可被用于应用的导航。
ActionBar 是在Android 3.0(API 11)中加入到SK中的,想在低版本中使用ActionBar有两种选择:使用http://actionbarsherlock.com 或使用Support Library v7。
下面是一张使用ActionBar的界面截图:

actionBar android 显示 安卓actionbar_ide

其中,[1]是ActionBar的图标,[2]是两个action按钮,[3]是overflow按钮

2、使用ActionBar

开发API11以下的程序,首先必须在AndroidManifest.xml中指定Application或Activity的theme是Theme.Holo或其子类,否则将无法使用ActionBar。

2.1 创建Actions

Actions即ActionBar中的每个交互项,可以在代码中创建Action,也可以在XML文件中指定(位于res/menu)。在menu资源文件中定义Action的方法如下:

 

[java] view plaincopy

 

1. <menu xmlns:android="http://schemas.android.com/apk/res/android" >  
2.     <item  
3. "@+id/action_refresh"  
4. "100"  
5. "always"  
6. "@drawable/ic_action_refresh"  
7. "Refresh"/>  
8.     <item  
9. "@+id/action_settings"  
10. "Settings">  
11.     </item>  
12. </menu>

showAsAction属性用来定义每个Action是如何显示的,always表示
永远显示在ActionBar中,如果屏幕空间不够则无法显示,ifRoom表示屏幕空间够的情况下显示在ActionBar中,不够的话就显示在overflow中,never则表示永远显示在overflow中。
在Activity中创建ctionBar的Action代码位于onCreateOptionsMenu()中,下面一段代码展示了创建过程:

 

 

[java] view plaincopy

 

1. @Override  
2. public boolean onCreateOptionsMenu(Menu menu) {  
3.     MenuInflater inflater = getMenuInflater();  
4.     inflater.inflate(R.menu.mainmenu, menu);  
5. return true;  
6.   }
  1.  

2.2 Action的按钮交互

 

如果一个Action被单击,对于activity中的onOptionsItemSelected()将被调用。该函数的传入参数是一个MenuItem。通过判断该MenuItem的Id,即可确认是哪个Action被单击。下面代码展示了该函数的使用过程。

 

[java] view plaincopy

 

1. Override  
2. public boolean onOptionsItemSelected(MenuItem item) {  
3. switch (item.getItemId()) {  
4. // action with ID action_refresh was selected  
5. case R.id.action_refresh:  
6. this, "Refresh selected", Toast.LENGTH_SHORT)  
7.           .show();  
8. break;  
9. // action with ID action_settings was selected  
10. case R.id.action_settings:  
11. this, "Settings selected", Toast.LENG  
12.           .show();  
13. break;  
14. default:  
15. break;  
16.     }  
17. return true;  
18.   }

onCreateOptionsMenu()只会被调用一次。若想改变Menu,可以调用invalidateOptionsMenu(),这会使onCreateOptionsMenu()将会再次被调用。
3. 自定义ActionBar
3.1 改变ActionBar的显示
在运行时显示和隐藏ActionBar的方法如下:

 

 

[java] view plaincopy

1. ActionBar actionBar = getActionBar();  
2. actionBar.hide();  
3. // more stuff here...  
4. actionBar.show();

可以改变显示在程序图标旁边的文字,如下所示:

 

 

[java] view plaincopy

 

1. ActionBar actionBar = getActionBar();  
2. actionBar.setSubtitle("mytest");  
3. actionBar.setTitle("vogella.com");

3.2 隐藏导航按钮
可以使用如下代码隐藏导航按钮。

 

 

[java] view plaincopy

 

1. getWindow().  
2.   getDecorView().  
3.   setSystemUiVisibility(View.SYSTEM_UI_FLAG_HIDE_NAVIGATION);

3.3 使用全屏模式
对于Android 4.4 (API 19)应用程序可以使用全屏模式,如下面代码所示。

 

 

[java] view plaincopy

 

1. // This method hides the system bars and resize the content  
2. private void hideSystemUI() {  
3.     getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN  
4. // hide nav bar  
5. // hide status bar  
6. // remove the following flag for version < API 19  
7.             | View.SYSTEM_UI_FLAG_IMMERSIVE);   
8.   }

3.4 使用Split action bar
在屏幕很窄时(如在portra模式),使用Split action bar可以将所有的action显示在屏幕底部,这样可以讲更有意义的元素如导航、标题等显示在activity的顶部
启用split action bar可在 AndroidManifest.xml中定义android:uiOptions="SplitActionBarWhenNarrow"
4. 在Fragment中给action bar添加action
在onCreate()中调用 setHasOptionsMenu(true)。Android Framework会调用Fragement中的onCreateOptionsMenu()来向Activity的Menu中添加item。

 

5. 动态设置action bar
5.1. 自定义action bar中显示的View
可以往action bar中添加自定义的View,如button或text。
可以使用ActionView的setCustomView,然后使用setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM)来Enable自定义View。
例子:先定义一个包含了EditText的布局文件。

[java] view plaincopy

 

1. <?xml version="1.0" encoding="utf-8"?>  
2. <EditText xmlns:android="http://schemas.android.com/apk/res/android"  
3. "@+id/searchfield"  
4. "match_parent"  
5. "match_parent"  
6. "textFilter" >  
7.   
8. </EditText>

下面的代码将上述布局文件添加到了一个Activity的action bar中。

 

 

[html] view plaincopy

 

1. package com.vogella.android.actionbar.customviews;  
2.   
3. import android.app.ActionBar;  
4. import android.app.Activity;  
5. import android.os.Bundle;  
6. import android.view.KeyEvent;  
7. import android.widget.EditText;  
8. import android.widget.TextView;  
9. import android.widget.TextView.OnEditorActionListener;  
10. import android.widget.Toast;  
11.   
12. public class MainActivity extends Activity {  
13.   
14.   @Override  
15.   protected void onCreate(Bundle savedInstanceState) {  
16.     super.onCreate(savedInstanceState);  
17.     setContentView(R.layout.activity_main);  
18.   
19. actionBar = getActionBar();  
20.     // add the custom view to the action bar  
21.     actionBar.setCustomView(R.layout.actionbar_view);  
22. search = (EditText) actionBar.getCustomView().findViewById(R.id.searchfield);  
23.     search.setOnEditorActionListener(new OnEditorActionListener() {  
24.   
25.       @Override  
26.       public boolean onEditorAction(TextView v, int actionId,  
27.           KeyEvent event) {  
28.         Toast.makeText(MainActivity.this, "Search triggered",  
29.             Toast.LENGTH_LONG).show();  
30.         return false;  
31.       }  
32.     });  
33.     actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM  
34.         | ActionBar.DISPLAY_SHOW_HOME);  
35.   }  
36.   
37. }

完整的源码下载位置:自定义Android Action Bar的布局

 

5.2. Action View
Action View控件可以替换Action bar的Action按钮图标。可以利用这个特点将某个Action项替换成一个ProgressBar。可通过android:actionLayout或android:actionViewClass来定义一个布局文件或Widg来作为Action的action view。
Action View使用的效果图如下。

actionBar android 显示 安卓actionbar_android_02

actionBar android 显示 安卓actionbar_ide_03

首先是两个布局文件,第一个用于action view

 

[java] view plaincopy

 

1. <?xml version="1.0" encoding="utf-8"?>  
2. <ProgressBar xmlns:android="http://schemas.android.com/apk/res/android"  
3. "@+id/progressBar2"  
4. "wrap_content"  
5. "wrap_content">  
6.   
7. </ProgressBar>

第二个用于menu设置

 

 

[java] view plaincopy

1. <menu xmlns:android="http://schemas.android.com/apk/res/android" >  
2.   
3.     <item  
4. "@+id/menu_settings"  
5. "100"  
6. "always"  
7. "Settings"  
8.         />  
9.   
10.     <item  
11. "@+id/menu_load"  
12. "@drawable/navigation_refresh"  
13. "200"  
14. "always"  
15. "Load"/>  
16.   
17. </menu>
  1.  

Activity的代码如下:

 

 

[java] view plaincopy

1. package com.vogella.android.actionbar.progress;  
2.   
3. import android.app.ActionBar;  
4. import android.app.Activity;  
5. import android.os.AsyncTask;  
6. import android.os.Bundle;  
7. import android.view.Menu;  
8. import android.view.MenuItem;  
9.   
10. public class MainActivity extends Activity {  
11.   
12. private MenuItem menuItem;  
13.   
14. @Override  
15. protected void onCreate(Bundle savedInstanceState) {  
16. super.onCreate(savedInstanceState);  
17.     setContentView(R.layout.activity_main);  
18.     ActionBar actionBar = getActionBar();  
19.     actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_HOME  
20.         | ActionBar.DISPLAY_SHOW_TITLE | ActionBar.DISPLAY_SHOW_CUSTOM);  
21.   }  
22.   
23. @Override  
24. public boolean onCreateOptionsMenu(Menu menu) {  
25.     getMenuInflater().inflate(R.menu.main, menu);  
26. return true;  
27.   }  
28.   
29. @Override  
30. public boolean onOptionsItemSelected(MenuItem item) {  
31. switch (item.getItemId()) {  
32. case R.id.menu_load:  
33.       menuItem = item;  
34.       menuItem.setActionView(R.layout.progressbar);  
35.       menuItem.expandActionView();  
36. new TestTask();  
37. "test");  
38. break;  
39. default:  
40. break;  
41.     }  
42. return true;  
43.   }  
44.   
45. private class TestTask extends AsyncTask<String, Void, String> {  
46.   
47. @Override  
48. protected String doInBackground(String... params) {  
49. // Simulate something long running  
50. try {  
51. 2000);  
52. catch (InterruptedException e) {  
53.         e.printStackTrace();  
54.       }  
55. return null;  
56.     }  
57.   
58. @Override  
59. protected void onPostExecute(String result) {  
60.       menuItem.collapseActionView();  
61. null);  
62.     }  
63.   };  
64. }

完整源码的下载地址:动态改变ActionBar的图标6. Action Provider
Action Provider提供了在单个组件里提供多种交互方式的方法。它可以用来创建action view,动态弹出子menu,处理action调用事件。基类为ActionProvider
目前Android平台提供两种action provider:MediaRouteActionProvider和ShareActionProvider。
下面以一个例子计算ShareActionProvider的用法。使用这个action provider可以让程序从注册了Intent.ACTION_SEND的Intent中获取。
首先定义Menu XML文件,并设置Item的android:actionProviderClass="android.widget.ShareActionProvider"

 

 

[java] view plaincopy

 

1. <?xml version="1.0" encoding="utf-8"?>  
2. <menu xmlns:android="http://schemas.android.com/apk/res/android" >  
3.   
4. "@+id/menu_share"  
5. "Share"  
6. "ifRoom"  
7. "android.widget.ShareActionProvider" />  
8.     <item  
9. "@+id/item1"  
10. "ifRoom"  
11. "More entries...">  
12.     </item>  
13.   
14. </menu>

设置一个包含了想要共享数据的Intent,将其发送。

 

 

[java] view plaincopy

1. @Override  
2. public boolean onCreateOptionsMenu(Menu menu) {  
3.     getMenuInflater().inflate(R.menu.activity_main, menu);  
4.   
5. // Get the ActionProvider for later usage  
6.     provider = (ShareActionProvider) menu.findItem(R.id.menu_share)  
7.         .getActionProvider();  
8. return true;  
9.   }  
10.   
11. @Override  
12. public boolean onOptionsItemSelected(MenuItem item) {  
13. switch (item.getItemId()) {  
14. case R.id.menu_share:  
15.       doShare();  
16. break;  
17. default:  
18. break;  
19.     }  
20. return true;    
21.   }  
22.   
23. public void doShare() {  
24. // populate the share intent with data  
25. new Intent(Intent.ACTION_SEND);  
26. "text/plain");  
27. "This is a message for you");  
28.     provider.setShareIntent(intent);  
29.   }

7. 使用程序图标导航
7.1. 使用程序图标作为home icon
Action Bar的左侧图标称为home icon,可为这个图标设置一个Action。推荐做法是当按了这个图标,返回到Home Activity中。
下面的代码介绍了在Android4.1前的版本上使用home aciton。关键点是在onOptionsMenuItemSelected() 中使用android.R.id.home并启用actionbar的HomeIcon。SecondActivity将MainActivity作为HomeActivity。

[java] view plaincopy

1. package com.vogella.android.actionbar.homebutton;  
2.   
3. import android.os.Bundle;  
4. import android.app.ActionBar;  
5. import android.app.Activity;  
6. import android.content.Intent;  
7. import android.view.Menu;  
8. import android.view.MenuItem;  
9.   
10. public class SecondActivity extends Activity {  
11.   
12. @Override  
13. protected void onCreate(Bundle savedInstanceState) {  
14. super.onCreate(savedInstanceState);  
15.     setContentView(R.layout.activity_main);  
16.   
17. // enable the home button  
18.     ActionBar actionBar = getActionBar();  
19. true);//或者使用actionBar.setDisplayHomeAsUpEnabled(true);  
20.   }  
21.   
22. @Override  
23. public boolean onCreateOptionsMenu(Menu menu) {  
24.     getMenuInflater().inflate(R.menu.main, menu);  
25. return true;  
26.   }  
27.   
28. @Override  
29. public boolean onOptionsItemSelected(MenuItem item) {  
30. switch (item.getItemId()) {  
31. case android.R.id.home:  
32. new Intent(this, MainActivity.class);  
33.       intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);  
34.       startActivity(intent);  
35. break;  
36. // Something else  
37. case R.id.action_settings:  
38. new Intent(this, ThirdActivity.class);  
39.       startActivity(intent);  
40. default:  
41. break;  
42.     }  
43. return super.onOptionsItemSelected(item);  
44.   }  
45.   
46. }

在Android 4.1以上版本,可以按如下的方式在AndroidManifest.xml中设置parentActivityName属性。
完整代码下载地址:使用ActionBar的HomeIcon进行导航