ActionBar 的应用

转载：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的外观样式。