Android Action Bar 详解篇

 作者原创，转载请标明出处：http://blog.csdn.net/yuxlong2010

          作为Android 3.0之后引入的新的对象，ActionBar可以说是一个方便快捷的导航神器。它可以作为活动的标题，突出活动的一些关键操作（如“搜索”、“创建”、“共享”等）、作为菜单的灵活使用，还可以实现类似TabWidget的标签功能以及下拉导航的功能，系统能够很好根据不同的屏幕配置来适应ActionBar的外观，配合起Fragemtn可谓是十分强大。

          那么，对于今天的主角ActionBar怎么去添加？在Android3.0默认主题HloleFraphic（全息）主题中，已经创造了ActionBar，所以只要targetSdkVersion的值不低于11，创建的Activity中默认都会带有ActionBar。例如：

 <manifest ... >
     <uses-sdk android:minSdkVersion="4"
               android:targetSdkVersion="11" />
     ...
 </manifest>

          当然了，如果你不想为一个特定的Activity设置Action Bar，设置Activity主题为Theme.Holo.NoActionBar。

 <activity android:theme="@android:style/Theme.Holo.NoActionBar">

           或者在运行时通过调用hide()隐藏Action Bar。自然也有show()。

 ActionBar actionBar = getActionBar();
 actionBar.hide();

          下面我们从下拉导航、视窗操作、标签导航三个方面逐一讨论ActionBar

         第一，下拉导航

                    下拉导航最典型的应用场景就是在Google+中的使用，效果如下图：

          

图1；Google+                             图2：本文示例

实现此效果分如下几个步骤：

          1.初始化一个SpinnerAdapter 

 SpinnerAdapter mSpinnerAdapter = ArrayAdapter.createFromResource(this,
                 R.array.action_list,
                 android.R.layout.simple_spinner_dropdown_item);

  2.生成一个OnNavigationListener来响应ActionBar的菜单项点击操作

 /**
      * 在这里配合Fragment，实现不同的页面导航
      */
     OnNavigationListener mOnNavigationListener = new OnNavigationListener() {

         @Override
         public boolean onNavigationItemSelected(int position, long itemId) {
             Fragment newFragment = null;
             switch (position) {
             case 0:
                 newFragment = new Fragment1();
                 break;
             case 1:
                 newFragment = new Fragment2();
                 break;
             case 2:
                 newFragment = new Fragment3();
                 break;
             default:
                 break;
             }
             getSupportFragmentManager().beginTransaction()
                     .replace(R.id.container, newFragment, strings[position])
                     .commit();
             return true;
         }
     };

   3，将生成好的适配去和监听器塞给ActionBar

 actionBar = getActionBar();
 actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_LIST);//导航模式必须设为NAVIGATION_MODE_LIST
 actionBar.setListNavigationCallbacks(mSpinnerAdapter,
         mOnNavigationListener);

     第二，操作视窗

          先上效果图

    

        图3                                                                             图4                                                                   图5

          在上面的操作视窗里，增加了一个用于搜索的可选菜单项以及分享和设置的两个自定义ActionProVider。那么如何在一个活动中，在已有的ActionBar上添加这些操作视窗。同创建可选菜单一样，定义options.xml的menu文件如下：

 <?xml version="1.0" encoding="utf-8"?>
 <menu xmlns:android="http://schemas.android.com/apk/res/android" >

     <item
         android:id="@+id/menu_search"
         android:actionViewClass="android.widget.SearchView"
         android:icon="@drawable/ic_menu_search"
         android:showAsAction="ifroom"
         android:title="搜索"/>
     <item
         android:id="@+id/menu_share"
         android:actionProviderClass="android.widget.ShareActionProvider"
         android:showAsAction="never"
         android:title="分享"/>
     <item
         android:id="@+id/menu_setting"
         android:actionProviderClass="com.example.tabdemo.MyActionProvider"
         android:showAsAction="never"
         android:title="设置">
         <menu>
             <item
                 android:id="@+id/menu_theme"
                 android:actionProviderClass="com.example.tabdemo.MyActionProvider"
                 android:showAsAction="always|withText"
                 android:title="更换主题"/>
             <item
                 android:id="@+id/menu_system"
                 android:actionProviderClass="com.example.tabdemo.MyActionProvider"
                 android:showAsAction="always|withText"
                 android:title="系统设置"/>
         </menu>
     </item>
 </menu>

          仔细观察可以发现每个Item里都包含如下这两个属性：

 android:actionProviderClass="com.example.tabdemo...."

 android:showAsAction=""

          对于actionProviderClass属性用来指定一个构建视窗所使用的布局资源，除了使用 actionProviderClass指定外，还可以使用actionLayout 或者actionViewClass都可以。SearchView和ShareActionProvider都是系统自带的ActionProvider，MyActionProvider是我们要重写的，后面将会看到如何去自定义一个ActionProvider。

          showAsAction属性共有五个值：ifRoom、never、always、withText、collapseActionView，可以混合使用。

ifRoom	会显示在Item中，但是如果已经有4个或者4个以上的Item时会隐藏在溢出列表中。当然个 数并不仅仅局限于4个，依据屏幕的宽窄而定
never	永远不会显示。只会在溢出列表中显示，而且只显示标题，所以在定义item的时候，最好 把标题都带上。
always	无论是否溢出，总会显示。
withText	withText值示意Action bar要显示文本标题。Action bar会尽可能的显示这个 标题，但是，如果图标有效并且受到Action bar空间的限制，文本标题有可 能显示不全。
collapseActionView	声明了这个操作视窗应该被折叠到一个按钮中，当用户选择这个按钮时，这个操作视窗展开。否则， 这个操作视窗在默认的情况下是可见的，并且即便在用于不适用的时候，也要占据操作栏的有效空间。 一般要配合ifRoom一起使用才会有效果。

          注： 当你的应用程序正在Android4.0（API 级别 14）或以上的版本上运行，那么还有一种叫做“分隔操作栏”的额外模式对action bar有效。当你启用分隔操作栏模式时，在屏幕的底部会显示一个独立的横条，用于显示Activity在窄屏设备（如竖屏手机）上运行时的所有操作项。这里我们不过过多描述，有兴趣自己去研究。

          就像加载menu一样，在activity的onCreateOptionsMenu方法里调用上述的xml文件：

 getMenuInflater().inflate(R.menu.options, menu);

 //搜索视窗，因为showAsAction="ifRoom"，所以图三中出现了搜索按钮
 SearchView searchView = (SearchView) menu.findItem(R.id.menu_search)
         .getActionView();

 //分享视窗，因为showAsAction="never"，所以只能在溢出菜单中才看见到
 ShareActionProvider mShareActionProvider = (ShareActionProvider) menu
         .findItem(R.id.menu_share).getActionProvider();
 Intent shareIntent = new Intent(Intent.ACTION_SEND);
 shareIntent.setType("image/*");
 mShareActionProvider.setShareIntent(shareIntent);

 //设置视窗，MyActionProvider就是我们自定义的ActionProvider
 MyActionProvider myactionprovider = (MyActionProvider) menu.findItem(
         R.id.menu_setting).getActionProvider();
 return super.onCreateOptionsMenu(menu);

          显然，当成功运行的时候，结果如图三，当点击搜索按钮时，搜索按钮立刻变成了如图四的样子，变成可折叠的操作视窗。

          如何自定义操作视窗，定义一个类MyActionProvider继承自ActionProvider，并实现它的两口回调函数即可。如下：

 /**
  * @ClassName: MyActionProvider
  * @Description: 自定义一个视窗操作器，实现构造函数和onCreateActionView即可
  * @author yuxianglong
  * @date 2013-7-11 下午3:13:44
  *
  */
 public class MyActionProvider extends ActionProvider{

     private Context context;
     private LayoutInflater inflater;
     private View view;
     private ImageView button;
     public MyActionProvider(Context context) {
         super(context);
         // TODO Auto-generated constructor stub
         this.context = context;
         inflater = LayoutInflater.from(context);
         view = inflater.inflate(R.layout.myactionprovider, null);
     }


     @Override
     public View onCreateActionView() {
         // TODO Auto-generated method stub
         button = (ImageView) view.findViewById(R.id.button);
         button.setOnClickListener(new View.OnClickListener() {

             @Override
             public void onClick(View v) {
                 // TODO Auto-generated method stub
                 Toast.makeText(context, "是我，没错", Toast.LENGTH_SHORT).show();
             }
         });
         return view;
     }

 }

          如此一来，只要在options.xml里直接引用。运行成功效果如图五，点击溢出菜单，设置按钮出来了，如果继续点下去，回调出它的子菜单，因为我们在options.xml里给自定义的ActionProvider分配了子菜单。

                 当然了，最显眼的就是处理Action Bar上的应用程序图标，平时玩手机多的同学应该可以发现，好多应用的图标都是可以点击的，而且大多数都是回到了上一个Activity，或者说是主Activity。那么，如何触发应用程序图标呢，说白了应用程序图标也是一个菜单，并且其id是规定死的，所以只要我们在onOptionsItemSelected方法里去捕捉它的点击事件，做出响应：

 @Override
     public boolean onOptionsItemSelected(MenuItem item) {
         switch (item.getItemId())
            {
               case android.R.id.home:
                  Intent intent = new Intent(this, HomeActivity.class);
                  intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
                  startActivity(intent);
                  return true;
               default:
                  return super.onOptionsItemSelected(item);
            }
     }

          我们给Intent添加了FLAG_ACTIVITY_CLEAR_TOP标识，该标识的作用是在回到HomeActivity时，把在堆栈中处于HomeActivity上面的活动全部清除。如果这是候运行程序的话，如果系统版本小于4.0的话，是可以正常跑起来的，达到想要的效果，但如果系统大于或者等于4.0的话，那么点击应用图标是无效的。必须加上setHomeButtonEnabled=true，4.0一下 默认为true。如果还想要一个回退箭头的话，再加上一句setDisplayHomeAsUpEnabled(true);效果如下：

          这里我在扩展一下：使用过Navigation Drawer的同学应该了解，这里点击应用程序图标通常会作为拉出导航抽屉。通常在那种情况下是把活动的onOptionsItemSelected，传送给ActionBarDrawerToggle的onOptionsItemSelected。不多说了，感兴趣的同学自己去研究，后面会把Navigation Bar写出来。

     第三，导航选项标签

          当你想要在一个Activity中提供导航选择标签时，使用操作栏的选项标签是一个非常好的选择（而不是使用TabWidget类），因为系统会调整操作栏选项标签来适应不同尺寸的屏幕的需要，在屏幕足够宽的时候，导航选项标签会被放到主操作栏中；当屏幕太窄的时候，选项标签会被放到一个分离的横条中。如图下：

   

          要使用选项标签在Fragmengt之间切换，选择一个选项标签时执行一个Fragment事务，布局里包含一个用于放置跟每个Fragment对象关联的选项标签的ViewGroup对象。该对象有一个资源ID，以便能够在选项标签的切换代码中能够引用它。Activity的布局文件activity_main.xml定义如下：

 <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools"
     android:id="@+id/container"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     tools:context=".MainActivity"
     tools:ignore="MergeRootFrame" />

          这里的ViewGroup为FragmentLayout。Activity代码如下：

 /*
 * @ClassName: MainActivity
 * @Description: 继承自FragmentActivity,作为Fragment的holder-Activity使用，
 *               实现TabListener接口，当切Tab的时候达到切换Fragment的效果
 * @author yuxianglong
 * @date 2013-7-11 下午7:40:35
 *
  */
 public class MainActivity extends FragmentActivity implements
         ActionBar.TabListener {
     private ActionBar actionBar;

     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);
         actionBar = getActionBar();
         actionBar.setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);// 导航模式必须设为NAVIGATION_MODE_Tabs

         // For each of the sections in the app, add a tab to the action bar.

         actionBar.addTab(actionBar.newTab().setText(R.string.title_section1)
                 .setTabListener(this));
         actionBar.addTab(actionBar.newTab().setText(R.string.title_section2)
                 .setTabListener(this));
         actionBar.addTab(actionBar.newTab().setText(R.string.title_section3)
                 .setTabListener(this));

     }


     @Override
     public void onTabSelected(ActionBar.Tab tab,
             FragmentTransaction fragmentTransaction) {
         // When the given tab isselected, show the tabcontents in the
         // //container view.
         Fragment fragment3 = null;
         Fragment fragment1 = null;
         Fragment fragment2 = null;
         switch (tab.getPosition()) {
         case 0:
             if (fragment1 == null) {
                 fragment1 = new Fragment1();
             }
             getSupportFragmentManager().beginTransaction()
                     .replace(R.id.container, fragment1).commit();
             break;
         case 1:
             if (fragment2 == null) {
                 fragment2 = new Fragment2();
             }
             getSupportFragmentManager().beginTransaction()
                     .replace(R.id.container, fragment2).commit();
             break;
         case 2:
             if (fragment3 == null) {
                 fragment3 = new Fragment3();
             }
             getSupportFragmentManager().beginTransaction()
                     .replace(R.id.container, fragment3).commit();
             break;

         default:
             break;
         }

     }

     @Override
     public void onTabUnselected(ActionBar.Tab tab,
             FragmentTransaction fragmentTransaction) {
     }

     @Override
     public void onTabReselected(ActionBar.Tab tab,
             FragmentTransaction fragmentTransaction) {
     }

 }

          最后跑起来的效果如下：

          至此ActionBar的一些常见使用场景，我们就熟悉了，后面继续研究ActionBar的外观样式。