本文根据Android Developer和SDK example的总结:
这里所使用的都是appcompat v7 support library里面的Actionbar。
添加ActionBar
- 创建一个Activity继承ActionBarActivity.
- 给你的Activity指定“Theme.AppCompat”或者继承它的一个主题。 例如:
<activity android:theme="@style/Theme.AppCompat.Light" ... >
删除ActionBar
可以在运行时隐藏ActionBar。例如:
ActionBar actionBar = getSupportActionBar();
actionBar.hide();
关于ActionBar的icon和logo
- 如果使用的是Material主题(>=API21)的时候,Navigation button(以前是“Home”)代替了之前应用icon的位置。也就是说L之后ActionBar左上角默认是Navigation button了而不是应用的icon或者logo。
- 通过调用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
- 添加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>
- 在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
- 要使用带有“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>
- 在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的功能需要做两个事情。
- 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).
- 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>