文章介绍ActionBar的使用,参考Android官方资料ActionBar
1.ActinBar支持的添加
ActionBar是Android3.0(API levle 11)添加的新特性,在Android3.0及以上平台中只需要以下代码便实现:
import android.app.ActionBar;
在Android3.0以下平台需要导入支持库(Android导入支持库教程):
import android.support.v7.app.ActionBar;
import android.support.v7.app.ActionBarActivity
并且,在Android3.0以下平台,你的Activity必须扩展ActionBarActivity,你的application或者activity必须使用Theme.AppCompat主题或扩展自Theme.AppCompat的主题:
public class MainActivity extends ActionBarActivity{/**/}
<application android:theme="@style/Theme.AppCompat.Light" >
至此,你的Activity已经拥有一个默认样式的的ActionBar了。
2.运行时显示/隐藏ActionBar
在Android3.0及以上平台中只需要以下代码获取当前Activity的ActionBar的实例:
ActionBar actionBar = getActionBar();
在Android3.0以下平台使用以下代码获取ActionBar实例:
ActionBar actionBar = getSupportActionBar();
获取到ActionBar引用后就可对ActionBar进行显示/隐藏了。
actionBar.show();//显示ActionBar
actionBar.hide();//隐藏ActionBar
3.使ActionBar支持导航到"父Activity"
所谓导航到父Activity,就是点击ActionBar左端的Icon或者logo时可以回到当前Activity的上一个Activity,只需一行代码即可:
actionBar.setDisplayHomeAsUpEnabled(true);
可以在manifest文件中指定当前Activity的父Activity:
从Android4.1(API level 16)开始,只需要在activity元素中声明parentActivityName即可;为了支持低版本平台,需要为activity添加meta-data子元素:
<activity
android:name="com.liuyz.actionbardemo.OtherActivity"
android:label="@string/title_activity_other"
android:parentActivityName="com.liuyz.actionbardemo.MainActivity" >
<!-- 使actionbar可以导航到上一个activity,api16及以上需要指定当前activity的 parentActivityName属性值为上一个activity的全限定名;
api16以下需为当前activity添加meta-data子元素 如下 -->
<meta-data android:name="android.support.PARENT_ACTIVITY"
android:value="com.liuyz.actionbardemo.MainActivity" />
</activity>
4.为ActionBar添加Action Button
Action Button的资源文件存放于res/menu/下,如main.xml
<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"
tools:context="com.liuyz.actionbardemo.MainActivity" >
<item
android:id="@+id/action_settings"
android:orderInCategory="100"
android:title="@string/action_settings"
app:showAsAction="never"/>
<item
android:id="@+id/action_search"
android:icon="@drawable/ic_action_search"
android:orderInCategory="102"
android:title="@string/action_search"
app:showAsAction="ifRoom"/>
<item
android:id="@+id/action_new"
android:icon="@drawable/ic_action_new"
android:orderInCategory="103"
android:title="@string/action_new"
app:showAsAction="ifRoom"/>
<item
android:id="@+id/action_edit"
android:icon="@drawable/ic_action_edit"
android:orderInCategory="104"
android:title="@string/action_edit"
app:showAsAction="ifRoom"/>
<item
android:id="@+id/action_refresh"
android:icon="@drawable/ic_action_refresh"
android:orderInCategory="105"
android:title="@string/action_refresh"
app:showAsAction="ifRoom"/>
<item
android:id="@+id/action_remove"
android:icon="@drawable/ic_action_remove"
android:orderInCategory="106"
android:title="@string/action_remove"
app:showAsAction="ifRoom"/>
</menu>
该文件声明了6个item,其中showAsAction属性,ifRoom表示如果ActionBar有足够的空间则将该item显示在ActionBar,否则显示到Menu菜单中;never表示永远显示在Menu菜单中,无论空间是否足够。orderInCategory属性值小的item优先显示到ActionBar。竖屏和横屏显示效果如下:
在需要添加Action Button的Activity中重写onCreateOptionsMenu方法将这6个item添加到ActionBar:
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// 填充menu到ActionBar
getMenuInflater().inflate(R.menu.main, menu);
//可以在次为menu items添加监听
return true;
}
重写onOptionsItemSelected方法为每个menu添加点击事件响应:
@Override
public boolean onOptionsItemSelected(MenuItem item) {
// Handle action bar item clicks here. The action bar will
// automatically handle clicks on the Home/Up button, so long
// as you specify a parent activity in AndroidManifest.xml.
int id = item.getItemId();
switch (id) {
case R.id.action_settings:
showToastShort("settings");
break;
case R.id.action_search:
showToastShort("search");
break;
case R.id.action_new:
showToastShort("new");
break;
case R.id.action_edit:
showToastShort("edit");
break;
case R.id.action_refresh:
showToastShort("refresh");
break;
case R.id.action_remove:
showToastShort("remove");
break;
default:
break;
}
return super.onOptionsItemSelected(item);
}
5.分离ActionBar与Action Button
在较窄的屏幕上使ActionBar与Action Button分离,Action Button显示到屏幕的下方,添加uiOptions属性到application或者activity元素,api14及以下需要在activity内添加子元素meta-data,如下:
<activity
android:name="com.liuyz.actionbardemo.MainActivity"
android:label="@string/app_name"
android:uiOptions="splitActionBarWhenNarrow" >
<!-- 在窄屏幕或竖屏上使actionBar与action button分离,将action显示在屏幕的下方,添加uiOptions属性到application或者activity元素;
api14及以下需添加如下子元素meta-data到activity -->
<meta-data
android:name="android.support.UI_OPTIONS"
android:value="splitActionBarWhenNarrow" />
</activity>
效果如下: