【Android】ActionBar的使用（1）

前（fei）言（hua）：转行iOS开发半年，很久没接触Android了，前几天去上课，听着实在无聊，随手拿了同学的一本《Android UI设计》，发现有好多基础知识自己虽然用过，但是都是当初做Android开发时，当项目需要的用到的时候才去百度，control+c和control+v后，便草草完事，以至于有时再需要使用某个控件或者功能时，再去百度或者翻查以前的代码。虽然曾经做了2年Android开发，但只是做了几个很水的app，为了不亏欠那两年奋斗的青春，现在开始，我将写一些关于Android基础的blog，祭奠下学Android的两年青春。废话不多说，这是这个系列第一篇《ActionBar的使用（1）》

1.什么是ActionBar？

Android的action bar是一个window 特性，能显示用户现在所处app的哪个页面（显示页面标题）、提供动作按钮（搜索、新增等）和导航（返回），和iOS的UINavigationBar作用一样。直接上官方图：

这是一个ActionBar例子，包含 [1] app icon, [2] 两个action items, 和 [3] action overflow.

ActionBar从 Android 3.0 (API level 11) 开始提供，如果我们新建的项目仅支持Android 3.0及以上，我们可以直接使用框架中的ActionBar API。如果要在 Android 2.1 (API level 7)及以上版本中使用，可以通过添加android-support-v4.jar后使用。上面提到的两种情况下，大多数API是一样的，只是包名不同：

API11以上

import android.app.ActionBar

API11以下

import android.support.v7.app.ActionBar

考虑到现在的Android手机版本都在4.0以及上，本文主要使用android.app.ActionBar。

新建项目时，只要 targetSdkVersion 或者 minSdkVersion设置为“11”或以上 ，Activity默认使用主题为 Theme.Holo，都带有ActionBar了，如果不需要使用ActionBar，可以将主题设为Theme.Holo.NoActionBar。

1.获取、隐藏和显示ActionBar

ActionBar actionBar = getActionBar();//获取ActionBar

actionBar.hide();//隐藏ActionBar

当actionBar被隐藏后，系统会自动调节布局来适配屏幕空间，可以调用show()来让actionBar重新显示。

*使用android-support-v4时，将getActionBar()改为getSupportActionBar()

2.添加Action Items

当我们的activity start，系统会调用activity的onCreateOptionsMenu()方法来创建action items，使用这个方法来加载定义了action items的菜单资源，例如，要添加两个action items，在res目录下新建一个文件夹，命名为menu，并新建一个xml文件，命名为main_activity_actions.xml， 添加以下代码，这段代码定义了两个action items：

res/menu/main_activity_actions.xml

<menu xmlns:android="http://schemas.android.com/apk/res/android" >
    <item android:id="@+id/action_search"
          android:icon="@drawable/ic_action_search"
          android:title="@string/action_search"/>
    <item android:id="@+id/action_compose"
          android:icon="@drawable/ic_action_compose"
          android:title="@string/action_compose" />
</menu>

在activity的onCreateOptionsMenu()方法中，加载上面的布局

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // Inflate the menu items for use in the action bar
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.main_activity_actions, menu);
    return super.onCreateOptionsMenu(menu);
}

运行后效果如下：

但是我们的需求是action item直接显示在actionBar上，而不是在action overflow中，因此需要在每个<item>中，添加showAsAction=“ifRoom”，那么只要空间足够，每个action item都将单独显示(不建议使用always)，例如：

<menu xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:yourapp="http://schemas.android.com/apk/res-auto" >
    <item android:id="@+id/action_search"
          android:icon="@drawable/ic_action_search"
          android:title="@string/action_search"
          yourapp:showAsAction="ifRoom"  />
    ...
</menu>

效果如下：

如果希望action item同时显示图片和文字，我们只要修改showAsAction的值：

showAsAction="ifRoom|withText"

3.处理action items的点击事件

当用户点击action时，系统会调用activity的 onOptionsItemSelected()方法，通过调用MenuItem的getItemId()方法，得到<item> 中id属性的值，就可以确定是哪个action被点击:

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    // Handle presses on the action bar items
    switch (item.getItemId()) {
        case R.id.action_search:
            openSearch();
            return true;
        case R.id.action_compose:
            composeMessage();
            return true;
        default:
            return super.onOptionsItemSelected(item);
    }
}

	private void openSearch(){
		System.out.println("action_search被点击了");
	}
	
	private void composeMessage(){
		System.out.println("action_compose被点击了");
	}

如果是使用fragment来inflate菜单，当用户单击action item时，系统会通过Fragment类的onCreateOptionsMenu()的回调，来调用 onOptionsItemSelected()方法。但是，activity会先处理点击事件，所以在activity的onOptionsItemSelected()中，要返回ture，activity中的fragments才有机会执行fragment的onCreateOptionsMenu()方法。

4.使用分隔的action bar

先上官方效果图：

分隔的actionBar可以将action item置于屏幕底部。如何实现呢？

1.如果API是14及以上，只需要在每个<activity> 或 <application>中添加 android:uiOptions=“splitActionBarWhenNarrow" 

2.如果API是14以下，需要在每个 <activity>中添加 <meta-data>，如下：

<manifest ...>
    <activity uiOptions="splitActionBarWhenNarrow" ... >
        <meta-data android:name="android.support.UI_OPTIONS"
                   android:value="splitActionBarWhenNarrow" />
    </activity>
</manifest>

如果要实现图3中隐藏icon和title的效果，还需在activity中添加下面两行代码：

actionBar.setDisplayShowHomeEnabled(false) ;
actionBar.setDisplayShowTitleEnabled(false);

5.使用ActionBar上的icon来导航

可以将actionBar上的icon图标来作为返回按钮，就像iOS中的导航栏中的leftBarButtonItem，例如屏幕A显示一个列表，选择类表中的一项时，跳转到屏幕B，屏幕B可以包含返回按钮，来返回到屏幕A。

调用ActionBar实例的setDisplayHomeAsUpEnabled()方法即可显示actionBar的返回按钮（如下面代码）。现在可以看见了返回图标了。

actionBar.setDisplayHomeAsUpEnabled(true);

但是默认按了之后并没有任何效果。因此还需要使用下面两种方法的任何一种进行配置：

方法一。在manifest文件中声明上级activity

如果上级Activity是固定的，只需在manifest中声明，用户按了返回按钮后，actionBar就会自动跳回对应的activity，在Android 4.1 (API level 16)开始，可以在<activity>中直接设置parentActivityName属性来设置父activity，而在之前的版本中，添加一个<meta-data>元素来设置父activity：

<application ... >
    ...
    <!-- The main/home activity (has no parent activity) -->
    <activity
        android:name="com.example.myfirstapp.MainActivity" ...>
        ...
    </activity>
    <!-- A child of the main activity -->
    <activity
        android:name="com.example.myfirstapp.DisplayMessageActivity"
        android:label="@string/title_activity_display_message"
        android:parentActivityName="com.example.myfirstapp.MainActivity" >
        <!-- Parent activity meta-data to support API level 7+ -->
        <meta-data
            android:name="android.support.PARENT_ACTIVITY"
            android:value="com.example.myfirstapp.MainActivity" />
    </activity>
</application>

方法二。通过在Activity中overridegetSupportParentActivityIntent()和onCreateSupportNavigateUpTaskStack() 方法

这个方法适用于用户可能是通过不同的activity跳转到目前这个activity的情况，本文不做详细介绍，可以看官方文档：http://developer.android.com/training/implementing-navigation/ancestral.html

6.添加Action View

有时，简单的button并不能满足我们的需求，为了实现更多功能，我们还可以用action view.  action view是显示在actionBar 上作为相当于action button的wedget，例如，如果需要搜索功能，可以添加一个嵌入了SearchView widget的action view到actionBar中。如图所示是一个包含可折叠搜索栏的actionBar。

要声明一个action view，分别使用actionLayout 和actionViewClass 属性来说明需要使用的layout或者widget，例如，下面代码添加了SearchView widget：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android" >
    <item android:id="@+id/action_search"
          android:icon="@drawable/ic_action_search"
          android:title="@string/action_search"
          android:showAsAction="ifRoom| collapseActionView"
          android:actionViewClass="android.widget.SearchView" />
   
</menu>

如果要配置action view（例如添加监听器），可以在onCreateOptionsMenu()中通过menu.findItem(R.id.action_search).getActionView()来获取，例如：

@Override
	public boolean onCreateOptionsMenu(Menu menu) {
	    // Inflate the menu items for use in the action bar
	    MenuInflater inflater = getMenuInflater();
	    inflater.inflate(R.menu.main_activity_actions, menu);
	    
	    SearchView searchItem = (SearchView) menu.findItem(R.id.action_search).getActionView();
	    //进行SearchView的设置，例如设置监听器等...
	    
	    return super.onCreateOptionsMenu(menu);
	}

其中关于SearchView控件的使用不在本文范围，可以参考官方文档：http://developer.android.com/guide/topics/search/search-dialog.html

由于篇幅关系，《ActionBar的使用（1）》先讲到这里，下一篇《ActionBar的使用（2）》将继续介绍ActionBar的其它用法（Action Provider、Navigation Tabs、Drop-down Navigation等），希望大家继续关注，我将尽快更新。