Android ActionBar 使用总结

本文根据Android Developer和SDK example的总结：

这里所使用的都是appcompat v7 support library里面的Actionbar。

添加ActionBar

1. 创建一个Activity继承ActionBarActivity.
2. 给你的Activity指定“Theme.AppCompat”或者继承它的一个主题。 例如：

<activity android:theme="@style/Theme.AppCompat.Light" ... >

删除ActionBar

　　可以在运行时隐藏ActionBar。例如：

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

关于ActionBar的icon和logo

1. 如果使用的是Material主题（>=API21）的时候，Navigation button（以前是“Home”）代替了之前应用icon的位置。也就是说L之后ActionBar左上角默认是Navigation button了而不是应用的icon或者logo。
2. 通过调用getSupportActionBar().setDisplayOptions 修改DisplayOptions来改变ActionBar的显示内容，DisplayOptions常量有5个，可以结合起来使用。

DisplayOptions	Functions	Description
DISPLAY_USE_LOGO	setDisplayUseLogoEnabled	用LOGO代替标准的icon
DISPLAY_SHOW_HOME	setDisplayShowHomeEnabled	显示Home元素，包括logo和icon
DISPLAY_HOME_AS_UP	setDisplayHomeAsUpEnabled	显示Home元素并且承担向上导航的功能（可以显示返回箭头）
DISPLAY_SHOW_TITLE	setDisplayShowTitleEnabled	显示Title和Subtitle
DISPLAY_SHOW_CUSTOM	setDisplayShowCustomEnabled	显示用户自定义的View

Add and Handle Action Items

1. 添加menu资源，要注意app:showAsAction 而不是 android:showAsAction，因为我们用的support library里面的ActionBar。 至于showAsAction的取值参考官网api。

<menu xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto"
      xmlns:tools="http://schemas.android.com/tools">

    <item android:id="@+id/menu_refresh"
          android:title="Refresh"
          android:icon="@drawable/ic_action_refresh"
          app:showAsAction="ifRoom"/>   <!-- Using XML attributes from the support library -->

    <item android:id="@+id/menu_settings"
          android:title="Settings"
          android:icon="@drawable/ic_action_settings"
          app:showAsAction="never"/>
</menu>

1. 在onCreateOptionsMenu中加载menu资源，可以通过menu.add来添加menu item，当然调用showAsAction时一定要用MenuItemCompat.setShowAsAction

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {

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

        MenuItem locationItem = menu.add(Menu.NONE, R.id.menu_location, 0, "Location");
        locationItem.setIcon(R.drawable.ic_action_location);
        // Need to use MenuItemCompat methods to call any action item related methods
        MenuItemCompat.setShowAsAction(locationItem, MenuItem.SHOW_AS_ACTION_IF_ROOM);

        return true;
    }

List Popup Menu

弹出菜单，PopupMenu 可以根据 构造函数里的new PopupMenu(getActivity(), view) 参数 view来设置弹出位置的锚点。

   private void showPopupMenu(View view) {
        final PopupAdapter adapter = (PopupAdapter) getListAdapter();

        // Retrieve the clicked item from view's tag
        final String item = (String) view.getTag();

        // Create a PopupMenu, giving it the clicked view for an anchor
        PopupMenu popup = new PopupMenu(getActivity(), view);

        // Inflate our menu resource into the PopupMenu's Menu
        popup.getMenuInflater().inflate(R.menu.popup, popup.getMenu());

        // Set a listener so we are notified if a menu item is clicked
        popup.setOnMenuItemClickListener(new PopupMenu.OnMenuItemClickListener() {
            @Override
            public boolean onMenuItemClick(MenuItem menuItem) {
                switch (menuItem.getItemId()) {
                    case R.id.menu_remove:
                        // Remove the item from the adapter
                        adapter.remove(item);
                        return true;
                }
                return false;
            }
        });

        // Finally show the PopupMenu
        popup.show();
    }

添加一个Action Provider

使用 ShareActionProvider

1. 要使用带有“ShareActionProvider”的share action，需要给item加一个tag指定ShareActionProvider class，如下：

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

    <item android:id="@+id/menu_share"
          android:title="@string/menu_share"
          app:showAsAction="ifRoom"
    app:actionProviderClass="android.support.v7.widget.ShareActionProvider"/>
</menu>

1. 在onCreateOptionsMenu中为ShareActionProvider设置Intent。

private ShareActionProvider mShareActionProvider;

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.main_activity_actions, menu);

    // Set up ShareActionProvider's default share intent
    MenuItem shareItem = menu.findItem(R.id.menu_share);
    mShareActionProvider = (ShareActionProvider)
            MenuItemCompat.getActionProvider(shareItem);
    mShareActionProvider.setShareIntent(getDefaultIntent());

    return super.onCreateOptionsMenu(menu);
}

/** Defines a default (dummy) share intent to initialize the action provider.
  * However, as soon as the actual content to be used in the intent
  * is known or changes, you must update the share intent by again calling
  * mShareActionProvider.setShareIntent()
  */
private Intent getDefaultIntent() {
    Intent intent = new Intent(Intent.ACTION_SEND);
    intent.setType("image/*");
    //intent.putExtra(Intent.EXTRA_STREAM, getContentUri());  // 文件Uri
    // intent.setType("text/plain");
    //  intent.putExtra(Intent.EXTRA_TEXT, context.getString(contentResourceId)); // 文字
    return intent;
}

split action bar

split action bar可以分离bar到屏幕的底部去显示所有的action items，前提是在小屏幕的手机上。（Android 5.0之后似乎被废弃了，官方文档上没有明确说明，但是设置了却不起作用。在设置了holo主题后才有效果@android:style/Theme.Holo.Light.DarkActionBar）
开始分离action bar的功能需要做两个事情。

1. Add uiOptions=”splitActionBarWhenNarrow” to each element or to the element. This attribute is understood only by API level 14 and higher (it is ignored by older versions).
2. To support older versions, add a element as a child of each element that declares the same value for “android.support.UI_OPTIONS”.
   例如：

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