当前位置: 移动技术网 > IT编程>移动开发>Android > Android ActionBar完全解析使用官方推荐的最佳导航栏(上)

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

2019年07月24日  | 移动技术网IT编程  | 我要评论

酒店用品,网王之恋猫物语,方逸华照片

本篇文章主要内容来自于android doc,我翻译之后又做了些加工,英文好的朋友也可以直接去读原文。

action bar是一种新増的导航栏功能,在android 3.0之后加入到系统的api当中,它标识了用户当前操作界面的位置,并提供了额外的用户动作、界面导航等功能。使用actionbar的好处是,它可以给提供一种全局统一的ui界面,使得用户在使用任何一款软件时都懂得该如何操作,并且actionbar还可以自动适应各种不同大小的屏幕。下面是一张使用actionbar的界面截图:

其中,[1]是actionbar的图标,[2]是两个action按钮,[3]是overflow按钮。

由于action bar是在3.0以后的版本中加入的,如果想在2.x的版本里使用actionbar的话则需要引入support library,不过3.0之前版本的市场占有率已经非常小了,这里简单起见我们就不再考虑去做向下兼容,而是只考虑4.0以上版本的用法。

添加和移除action bar

actionbar的添加非常简单,只需要在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的图标已经修改成功了,那么标题中的内容该怎样修改呢?其实也很简单,使用label属性来指定一个字符串就可以了,如下所示:

<activity android:name="com.example.actionbartest.mainactivity"
 android:label="天气" 
 android:logo="@drawable/weather" > 
</activity> 

现在重新运行一下程序,结果如下图所示:

添加action按钮

actionbar还可以根据应用程序当前的功能来提供与其相关的action按钮,这些按钮都会以图标或文字的形式直接显示在actionbar上。当然,如果按钮过多,actionbar上显示不完,多出的一些按钮可以隐藏在overflow里面(最右边的三个点就是overflow按钮),点击一下overflow按钮就可以看到全部的action按钮了。

当activity启动的时候,系统会调用activity的oncreateoptionsmenu()方法来取出所有的action按钮,我们只需要在这个方法中去加载一个menu资源,并把所有的action按钮都定义在资源文件里面就可以了。

那么我们先来看下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>标签定义了三个action按钮。<item>标签中又有一些属性,其中id是该action按钮的唯一标识符,icon用于指定该按钮的图标,title用于指定该按钮可能显示的文字(在图标能显示的情况下,通常不会显示文字),showasaction则指定了该按钮显示的位置,主要有以下几种值可选: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); 
} 

这部分代码很简单,仅仅是调用了menuinflater的inflate()方法来加载menu资源就可以了。现在重新运行一下程序,结果如下图所示:

可以看到,action_compose和action_delete这两个按钮已经在actionbar中显示出来了,而action_settings这个按钮由于showasaction属性设置成了never,所以被隐藏到了overflow当中,只要点击一下overflow按钮就可以看到它了。

这里我们注意到,显示在actionbar上的按钮都只有一个图标而已,我们在title中指定的文字并没有显示出来。没错,title中的内容通常情况下只会在overflow中显示出来,actionbar中由于屏幕空间有限,默认是不会显示title内容的。但是出于以下几种因素考虑,即使title中的内容无法显示出来,我们也应该给每个item中都指定一个title属性:
当actionbar中的剩余空间不足的时候,如果action按钮指定的showasaction属性是ifroom的话,该action按钮就会出现在overflow当中,此时就只有title能够显示了。

如果action按钮在actionbar中显示,用户可能通过长按该action按钮的方式来查看到title的内容。

响应action按钮的点击事件

当用户点击action按钮的时候,系统会调用activity的onoptionsitemselected()方法,通过方法传入的menuitem参数,我们可以调用它的getitemid()方法和menu资源中的id进行比较,从而辨别出用户点击的是哪一个action按钮,比如:

@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); 
 } 
} 

可以看到,我们让每个action按钮被点击的时候都弹出一个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界面,点击一下导航按钮都应该回到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中替换action按钮的控件,它可以允许用户在不切换界面的情况下通过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,这个值表示该控件可以被合并成一个action按钮。
现在重新运行一下程序,效果如下图所示:

ok,果然有一个搜索样式的action按钮出现了,现在点击一下这个搜索按钮,效果如下图所示:

可以看到,这时searchview就会展开占满整个actionbar,而其它的action按钮由于将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的更多详细用法,可以参考官方文档 。

除此之外,有些程序可能还希望在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操作就可以了。

overflow按钮不显示的情况

虽然现在我们已经掌握了不少actionbar的用法,但是当你真正去使用它的时候还是可能会遇到各种各样的问题,比如很多人都会碰到overflow按钮不显示的情况。明明是同样的一份代码,overflow按钮在有些手机上会显示,而在有些手机上偏偏就不显示,这是为什么呢?后来我总结了一下,overflow按钮的显示情况和手机的硬件情况是有关系的,如果手机没有物理menu键的话,overflow按钮就可以显示,如果有物理menu键的话,overflow按钮就不会显示出来。比如我们启动一个有menu键的模拟器,然后将代码运行到该模拟器上,结果如下图所示:

可以看到,actionbar最右边的overflow按钮不见了!那么此时我们如何查看隐藏在overflow中的action按钮呢?其实非常简单,按一下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键的手机上,也能让overflow按钮显示出来了,这样就可以大大增加我们软件界面和操作的统一性。

让overflow中的选项显示图标

如果你点击一下overflow按钮去查看隐藏的action按钮,你会发现这部分action按钮都是只显示文字不显示图标的,如下图所示:

这是官方的默认效果,google认为隐藏在overflow中的action按钮都应该只显示文字。当然,如果你认为这样不够美观,希望在overflow中的action按钮也可以显示图标,我们仍然可以想办法来改变这一默认行为。

其实,overflow中的action按钮应不应该显示图标,是由menubuilder这个类的setoptionaliconsvisible方法来决定的,如果我们在overflow被展开的时候给这个方法传入true,那么里面的每一个action按钮对应的图标就都会显示出来了。调用的方法当然仍然是用反射了,代码如下所示:

@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完全解析使用官方推荐的最佳导航栏(下)。

如对本文有疑问,请在下面进行留言讨论,广大热心网友会与你互动!! 点击进行留言回复

相关文章:

验证码:
移动技术网