Android ActionBar全然解析,使用官方推荐的最佳导航栏(上)

转载请注明出处:http://blog.csdn.net/guolin_blog/article/details/18234477


本篇文章主要内容来自于Android Doc。我翻译之后又做了些加工。英文好的朋友也能够直接去读原文。

http://developer.android.com/guide/topics/ui/actionbar.html


Action Bar是一种新増的导航栏功能。在Android 3.0之后加入到系统的API其中,它标识了用户当前操作界面的位置,并提供了额外的用户动作、界面导航等功能。

使用ActionBar的优点是,它能够给提供一种全局统一的UI界面,使得用户在使用不论什么一款软件时都懂得该怎样操作。而且ActionBar还能够自己主动适应各种不同大小的屏幕。

下面是一张使用ActionBar的界面截图:




其中。[1]是ActionBar的图标,[2]是两个actionbutton,[3]是overflowbutton。


因为Action Bar是在3.0以后的版本号中加入的。假设想在2.x的版本号里使用ActionBar的话则须要引入Support Library,只是3.0之前版本号的市场占有率已经很小了,这里简单起见我们就不再考虑去做向下兼容,而是仅仅考虑4.0以上版本号的使用方法。


加入和移除Action Bar


ActionBar的加入很easy,仅仅须要在AndroidManifest.xml中指定Application或Activity的theme是Theme.Holo或其子类就能够了,而使用Eclipse创建的项目自己主动就会将Application的theme指定成Theme.Holo。所以ActionBar默认都是显示出来的。新建一个空项目并执行。效果例如以下图所看到的:




而假设想要移除ActionBar的话通常有两种方式。一是将theme指定成Theme.Holo.NoActionBar,表示使用一个不包括ActionBar的主题,二是在Activity中调用下面方法:

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

如今又一次执行一下程序,就能够看到ActionBar不再显示了,例如以下图所看到的:




改动Action Bar的图标和标题


默认情况下,系统会使用<application>或者<activity>中icon属性指定的图片来作为ActionBar的图标,可是我们也能够改变这一默认行为。假设我们想要使用另外一张图片来作为ActionBar的图标,能够在<application>或者<activity>中通过logo属性来进行指定。比方项目的res/drawable文件夹下有一张weather.png图片。就能够在AndroidManifest.xml中这样指定:
<activity
    android:name="com.example.actionbartest.MainActivity"
    android:logo="@drawable/weather" >
</activity>
如今又一次执行一下程序,效果例如以下图所看到的:



OK,ActionBar的图标已经改动成功了,那么标题中的内容该怎样改动呢?事实上也很easy,使用label属性来指定一个字符串就能够了。例如以下所看到的:
<activity
    android:name="com.example.actionbartest.MainActivity"
    android:label="天气"
    android:logo="@drawable/weather" >
</activity>
如今又一次执行一下程序。结果例如以下图所看到的:



加入Actionbutton


ActionBar还能够依据应用程序当前的功能来提供与其相关的Actionbutton,这些button都会以图标或文字的形式直接显示在ActionBar上。

当然,假设button过多,ActionBar上显示不完。多出的一些button能够隐藏在overflow里面(最右边的三个点就是overflowbutton)。点击一下overflowbutton就能够看到全部的Actionbutton了。


当Activity启动的时候。系统会调用Activity的onCreateOptionsMenu()方法来取出全部的Actionbutton。我们仅仅须要在这种方法中去载入一个menu资源,并把全部的Actionbutton都定义在资源文件中面就能够了。

那么我们先来看下menu资源文件该怎样定义。代码例如以下所看到的:
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:context="com.example.actionbartest.MainActivity" >

    <item
        android:id="@+id/action_compose"
        android:icon="@drawable/ic_action_compose"
        android:showAsAction="always"
        android:title="@string/action_compose"/>
    <item
        android:id="@+id/action_delete"
        android:icon="@drawable/ic_action_delete"
        android:showAsAction="always"
        android:title="@string/action_delete"/>
    <item
        android:id="@+id/action_settings"
        android:icon="@drawable/ic_launcher"
        android:showAsAction="never"
        android:title="@string/action_settings"/>

</menu>
能够看到,这里我们通过三个<item>标签定义了三个Actionbutton。<item>标签中又有一些属性,其中id是该Actionbutton的唯一标识符。icon用于指定该button的图标,title用于指定该button可能显示的文字(在图标能显示的情况下,通常不会显示文字)。showAsAction则指定了该button显示的位置。主要有下面几种值可选:always表示永远显示在ActionBar中,假设屏幕空间不够则无法显示。ifRoom表示屏幕空间够的情况下显示在ActionBar中,不够的话就显示在overflow中,never则表示永远显示在overflow中。
接着,重写Activity的onCreateOptionsMenu()方法。代码例如以下所看到的:
@Override
public boolean onCreateOptionsMenu(Menu menu) {
	MenuInflater inflater = getMenuInflater();
	inflater.inflate(R.menu.main, menu);
	return super.onCreateOptionsMenu(menu);
}
这部分代码很easy,仅仅是调用了MenuInflater的inflate()方法来载入menu资源就能够了。如今又一次执行一下程序,结果例如以下图所看到的:



能够看到,action_compose和action_delete这两个button已经在ActionBar中显示出来了。而action_settings这个button因为showAsAction属性设置成了never。所以被隐藏到了overflow其中,仅仅要点击一下overflowbutton就能够看到它了。


这里我们注意到,显示在ActionBar上的button都仅仅有一个图标而已。我们在title中指定的文字并没有显示出来。没错,title中的内容通常情况下仅仅会在overflow中显示出来。ActionBar中因为屏幕空间有限,默认是不会显示title内容的。可是出于下面几种因素考虑,即使title中的内容无法显示出来,我们也应该给每一个item中都指定一个title属性:
  • 当ActionBar中的剩余空间不足的时候,假设Actionbutton指定的showAsAction属性是ifRoom的话。该Actionbutton就会出如今overflow其中,此时就仅仅有title能够显示了。

  • 假设Actionbutton在ActionBar中显示,用户可能通过长按该Actionbutton的方式来查看到title的内容。


响应Actionbutton的点击事件


当用户点击Actionbutton的时候。系统会调用Activity的onOptionsItemSelected()方法。通过方法传入的MenuItem參数,我们能够调用它的getItemId()方法和menu资源中的id进行比較,从而辨别出用户点击的是哪一个Actionbutton,比方:
@Override
public boolean onOptionsItemSelected(MenuItem item) {
	switch (item.getItemId()) {
	case R.id.action_compose:
		Toast.makeText(this, "Compose", Toast.LENGTH_SHORT).show();
		return true;
	case R.id.action_delete:
		Toast.makeText(this, "Delete", Toast.LENGTH_SHORT).show();
		return true;
	case R.id.action_settings:
		Toast.makeText(this, "Settings", Toast.LENGTH_SHORT).show();
		return true;
	default:
		return super.onOptionsItemSelected(item);
	}
}
能够看到,我们让每一个Actionbutton被点击的时候都弹出一个Toast,如今又一次执行一下代码。结果例如以下图所看到的:




通过Action Bar图标进行导航


启用ActionBar图标导航的功能,能够同意用户依据当前应用的位置来在不同界面之间切换。比方,A界面展示了一个列表,点击某一项之后进入了B界面,这时B界面就应该启用ActionBar图标导航功能。这样就能够回到A界面。

我们能够通过调用setDisplayHomeAsUpEnabled()方法来启用ActionBar图标导航功能。比方:
@Override
protected void onCreate(Bundle savedInstanceState) {
	super.onCreate(savedInstanceState);
	setTitle("天气");
	setContentView(R.layout.activity_main);
	ActionBar actionBar = getActionBar();
	actionBar.setDisplayHomeAsUpEnabled(true);
}
如今又一次执行一下程序,结果例如以下图所看到的:



能够看到,在ActionBar图标的左側出现了一个向左的箭头,通常情况下这都表示返回的意思,因此最简单的实现就是在它的点击事件里面加入finish()方法就能够了,例如以下所看到的:
	@Override
	public boolean onOptionsItemSelected(MenuItem item) {
		switch (item.getItemId()) {
		case android.R.id.home:
			finish();
			return true;
		……
		}
	}
当点击ActionBar图标的时候,系统相同会调用onOptionsItemSelected()方法。而且此时的itemId是android.R.id.home,所以finish()方法也就是加在这里的了。
如今看上去。ActionBar导航和Back键的功能貌似是一样的。

没错,假设我们仅仅是简单地finish了一下。ActionBar导航和Back键的功能是全然一样的,但ActionBar导航的设计初衷并非这种,它和Back键的功能还是有一些差别的。举个样例吧。




上图中的Conversation List是收件箱的主界面。如今我们点击第一封邮件会进入到Conversation1 details界面。然后点击下一封邮件会进入到Conversation 2 details界面,再点击下一封邮箱会进入到Conversation3 details界面。好的。这个时候假设我们按下Back键,应该会回到Conversation 2 details界面,再按一次Back键应该回到Conversation1 details界面。再按一次Back键才会回到Conversation List。

而ActionBar导航则不应该表现出这种行为,不管我们当前在哪一个Conversation details界面。点击一下导航button都应该回到Conversation List界面才对。


这就是ActionBar导航和Back键在设计上的差别。那么该怎样才干实现这种功能呢?事实上并不复杂。实现标准的ActionBar导航功能仅仅需三步走。

第一步我们已经实现了,就是调用setDisplayHomeAsUpEnabled()方法。并传入true。


第二步须要在AndroidManifest.xml中配置父Activity,例如以下所看到的:
<activity
    android:name="com.example.actionbartest.MainActivity"
    android:logo="@drawable/weather" >
    <meta-data
        android:name="android.support.PARENT_ACTIVITY"
        android:value="com.example.actionbartest.LaunchActivity" />
</activity>
能够看到,这里通过meta-data标签指定了MainActivity的父Activity是LaunchActivity。在Android 4.1版本号之后,也能够直接使用android:parentActivityName这个属性来进行指定。例如以下所看到的:
<activity
    android:name="com.example.actionbartest.MainActivity"
    android:logo="@drawable/weather"
    android:parentActivityName="com.example.actionbartest.LaunchActivity" >
</activity>
第三步则须要对android.R.id.home这个事件进行一些特殊处理。例如以下所看到的:
@Override
public boolean onOptionsItemSelected(MenuItem item) {
	switch (item.getItemId()) {
	case android.R.id.home:
		Intent upIntent = NavUtils.getParentActivityIntent(this);
		if (NavUtils.shouldUpRecreateTask(this, upIntent)) {
			TaskStackBuilder.create(this)
					.addNextIntentWithParentStack(upIntent)
					.startActivities();
		} else {
			upIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
			NavUtils.navigateUpTo(this, upIntent);
		}
		return true;
        ......
	}
}
其中,调用NavUtils.getParentActivityIntent()方法能够获取到跳转至父Activity的Intent。然后假设父Activity和当前Activity是在同一个Task中的,则直接调用navigateUpTo()方法进行跳转,假设不是在同一个Task中的,则须要借助TaskStackBuilder来创建一个新的Task。

这样,就依照标准的规范成功实现ActionBar导航的功能了。

加入Action View


ActionView是一种能够在ActionBar中替换Actionbutton的控件,它能够同意用户在不切换界面的情况下通过ActionBar完毕一些较为丰富的操作。比方说,你须要完毕一个搜索功能。就能够将SeachView这个控件加入到ActionBar中。


为了声明一个ActionView,我们能够在menu资源中通过actionViewClass属性来指定一个控件,比如能够使用例如以下方式加入SearchView:
<menu xmlns:android="http://schemas.android.com/apk/res/android" >

    <item
        android:id="@+id/action_search"
        android:icon="@drawable/ic_action_search"
        android:actionViewClass="android.widget.SearchView"
        android:showAsAction="ifRoom|collapseActionView"
        android:title="@string/action_search" />
    ......

</menu>
注意在showAsAction属性中我们还声明了一个collapseActionView,这个值表示该控件能够被合并成一个Actionbutton。
如今又一次执行一下程序,效果例如以下图所看到的:



OK,果然有一个搜索样式的Actionbutton出现了,如今点击一下这个搜索button。效果例如以下图所看到的:



能够看到,这时SearchView就会展开占满整个ActionBar,而其他的Actionbutton因为将showAsAction属性设置成了ifRoom,此时都会隐藏到overflow其中。


假设你还希望在代码中对SearchView的属性进行配置(比方加入监听事件等),全然没有问题。仅仅须要在onCreateOptionsMenu()方法中获取该ActionView的实例就能够了,代码例如以下所看到的:
@Override
public boolean onCreateOptionsMenu(Menu menu) {
	MenuInflater inflater = getMenuInflater();
	inflater.inflate(R.menu.main, menu);
	MenuItem searchItem = menu.findItem(R.id.action_search);
	SearchView searchView = (SearchView) searchItem.getActionView();
	// 配置SearchView的属性
	......
	return super.onCreateOptionsMenu(menu);
}
在得到了SearchView的实例之后,就能够随意地配置它的各种属性了。关于SearchView的很多其他具体使用方法,能够參考官方文档 http://developer.android.com/guide/topics/search/search-dialog.html 。


除此之外,有些程序可能还希望在ActionView展开和合并的时候显示不同的界面,事实上我们仅仅须要去注冊一个ActionView的监听器就能实现这种功能了,代码例如以下所看到的:
@Override
public boolean onCreateOptionsMenu(Menu menu) {
	MenuInflater inflater = getMenuInflater();
	inflater.inflate(R.menu.main, menu);
	MenuItem searchItem = menu.findItem(R.id.action_search);
	searchItem.setOnActionExpandListener(new OnActionExpandListener() {
		@Override
		public boolean onMenuItemActionExpand(MenuItem item) {
			Log.d("TAG", "on expand");
			return true;
		}
		
		@Override
		public boolean onMenuItemActionCollapse(MenuItem item) {
			Log.d("TAG", "on collapse");
			return true;
		}
	});
	return super.onCreateOptionsMenu(menu);
}
能够看到,调用MenuItem的setOnActionExpandListener()方法就能够注冊一个监听器了。当SearchView展开的时候就会回调onMenuItemActionExpand()方法。当SearchView合并的时候就会调用onMenuItemActionCollapse()方法,我们在这两个方法中进行相应的UI操作就能够了。


Overflowbutton不显示的情况


尽管如今我们已经掌握了不少ActionBar的使用方法,可是当你真正去使用它的时候还是可能会遇到各种各样的问题,比方很多人都会碰到overflowbutton不显示的情况。明明是相同的一份代码。overflowbutton在有些手机上会显示,而在有些手机上偏偏就不显示,这是为什么呢?后来我总结了一下,overflowbutton的显示情况和手机的硬件情况是有关系的。假设手机没有物理Menu键的话,overflowbutton就能够显示,假设有物理Menu键的话。overflowbutton就不会显示出来。

比方我们启动一个有Menu键的模拟器。然后将代码执行到该模拟器上,结果例如以下图所看到的:




能够看到,ActionBar最右边的overflowbutton不见了!

那么此时我们怎样查看隐藏在overflow中的Actionbutton呢?事实上很easy,按一下Menu键,隐藏的内容就会从底部出来了,例如以下图所看到的:




看到这里相信不少朋友都想吐槽一下了,这显然是一种很蛋疼的设计,在不同手机上居然显示了不同的界面,而且操作方法也全然不一样,这样会给用户一种很不习惯的感觉。话说Google为什么要把ActionBar的overflow设计成这样我也不太理解,可是我们还是有办法改变这一默认行为的。

实际上,在ViewConfiguration这个类中有一个叫做sHasPermanentMenuKey的静态变量,系统就是依据这个变量的值来推断手机有没有物理Menu键的。当然这是一个内部变量,我们无法直接訪问它。可是能够通过反射的方式改动它的值,让它永远为false就能够了,代码例如以下所看到的:
@Override
protected void onCreate(Bundle savedInstanceState) {
	......
	setOverflowShowingAlways();
}

private void setOverflowShowingAlways() {
	try {
		ViewConfiguration config = ViewConfiguration.get(this);
		Field menuKeyField = ViewConfiguration.class.getDeclaredField("sHasPermanentMenuKey");
		menuKeyField.setAccessible(true);
		menuKeyField.setBoolean(config, false);
	} catch (Exception e) {
		e.printStackTrace();
	}
}
这里我们在onCreate()方法的最后调用了setOverflowShowingAlways()方法,而这种方法的内部就是使用反射的方式将sHasPermanentMenuKey的值设置成false,如今又一次执行一下代码。结果例如以下图所看到的:



能够看到。即使是在有Menu键的手机上。也能让overflowbutton显示出来了,这样就能够大大添加我们软件界面和操作的统一性。

让Overflow中的选项显示图标


假设你点击一下overflowbutton去查看隐藏的Actionbutton,你会发现这部分Actionbutton都是仅仅显示文字不显示图标的。例如以下图所看到的:



这是官方的默认效果,Google觉得隐藏在overflow中的Actionbutton都应该仅仅显示文字。当然。假设你觉得这样不够美观,希望在overflow中的Actionbutton也能够显示图标。我们仍然能够想办法来改变这一默认行为。

事实上,overflow中的Actionbutton应不应该显示图标,是由MenuBuilder这个类的setOptionalIconsVisible方法来决定的。假设我们在overflow被展开的时候给这种方法传入true。那么里面的每一个Actionbutton相应的图标就都会显示出来了。调用的方法当然仍然是用反射了。代码例如以下所看到的:
@Override
public boolean onMenuOpened(int featureId, Menu menu) {
	if (featureId == Window.FEATURE_ACTION_BAR && menu != null) {
		if (menu.getClass().getSimpleName().equals("MenuBuilder")) {
			try {
				Method m = menu.getClass().getDeclaredMethod("setOptionalIconsVisible", Boolean.TYPE);
				m.setAccessible(true);
				m.invoke(menu, true);
			} catch (Exception e) {
			}
		}
	}
	return super.onMenuOpened(featureId, menu);
}
能够看到,这里我们重写了一个onMenuOpened()方法,当overflow被展开的时候就会回调这种方法,接着在这种方法的内部通过返回反射的方法将MenuBuilder的setOptionalIconsVisible变量设置为true就能够了。


如今又一次执行一下代码,结果例如以下图所看到的:



好了。眼下为止我们已经把ActionBar的基础知识介绍完了,那么今天的解说就到这里,下篇文章中我会带领大家一起更深入地了解ActionBar,感兴趣的朋友请继续阅读 Android ActionBar全然解析。使用官方推荐的最佳导航栏(下)

关注我的技术公众号,每天都有优质技术文章推送。关注我的娱乐公众号,工作、学习累了的时候放松一下自己。

微信扫一扫下方二维码就可以关注:

        

posted @ 2019-04-19 16:08  mqxnongmin  阅读(226)  评论(0编辑  收藏  举报