Android ToolBar 使用完全解析

作者: 丶蓝天白云梦 | 来源:发表于2016-05-07 11:08 被阅读39549次

    ToolBar简介

    ToolBar是Android 5.0推出的一个新的导航控件用于取代之前的ActionBar,由于其高度的可定制性、灵活性、具有Material Design风格等优点,越来越多的应用也用上了ToolBar,比如常用的知乎软件其顶部导航栏正是使用ToolBar。官方考虑到仍有一部分用户的手机版本号低于5.0,所以,ToolBar也放进了support v7包内,使得低版本的系统也能使用上ToolBar。本文将使用support v7支持包的ToolBar来进行讲解,包括其基本用法、样式定制等知识点。

    ToolBar的基本使用

    引入support v7支持包

    在你项目的build.gradle内输入如下代码,即能引入支持包,该支持包内有能向下兼容的ToolBar:

    dependencies {    
          compile fileTree(dir: 'libs', include: ['*.jar'])    
          compile 'com.android.support:appcompat-v7:23.1.1'
    }
    

    更改主题

    为了能够正常使用ToolBar,我们需要隐藏原来的ActionBar,这个可以在主题中修改,在values/styles.xml中做出如下修改:

    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">    
    </style>
    

    继承了Theme.Appcompat.Light.NoActionBar主题,这里提一下,这个Theme.AppCompat是支持包内的主题,对应着5.0版本的Theme.Material主题。然后在manifest文件中引用这个主题。

    在布局文件中创建这个控件,activity_main.xml文件中,代码如下所示:

    <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
        <android.support.v7.widget.Toolbar
            android:id="@+id/toolbar"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content">
            <TextView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="标题"
                android:textSize="20sp"/>
        </android.support.v7.widget.Toolbar>
    </FrameLayout>
    

    在上面,创建了android.support.v7.widget.Toolbar,同时我们在内部放了一个TextView,这是与ActionBar最大的不同,因为ToolBar实际上是一个ViewGroup,支持在其内部放入子View。ok,我们运行程序,得到如下结果:


    结果1.png

    可以看出ToolBar正常显示,当然了,这只是最简单的用法,接下来我们逐步添加内容、样式,使它看起开更加美,功能更加完善。

    ToolBar的完善

    一、首先我们考虑,改变ToolBar的颜色

    要想改变toolbar的颜色很简单,直接在布局文件中添加一个backgroud属性指定颜色就可以了,但是为了全局考虑,我们可以这样:在values/styles.xml文件中做出如下修改:

    <resources>
        <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
            <!-- Customize your theme here. -->
            <item name="colorPrimary">#2e8abb</item> <!--浅蓝色-->
            <item name="colorPrimaryDark">#3A5FCD</item> <!--深蓝色-->
        </style>
    </resources>
    

    然后在布局文件中,添加如下属性:

    android:background="?attr/colorPrimary"
    

    这样,就能方便对每一个toolbar引用同样的颜色了,我们先看看现在的效果是怎样的:

    结果2.png
    可以看到,颜色已经改变,同时我们注意到,顶部状态栏的颜色也变成了深蓝色,这是因为添加了"colorPrimaryDark"的属性,使得顶部状态栏随之改变,利用这一特性,我们可以轻松实现“状态栏沉浸”的效果了。当然,这只适用于Android 5.0以上,如果在低版本则这个属性无效。这里再附上一张图(图片来自http://blog.csdn.net/bbld_/article/details/41439715):
    样式说明
    根据图中的说明,我们可以轻松地在styles.xml文件中定制我们的样式,如果想要改变toolbar的title、subtitle以及menu中文字的颜色,可以利用“textColorPrimary”属性等。

    二、添加title、subtitle、logo、导航栏图标

    在MainActivity文件先获取控件的实例,接着通过一系列的set方法即可设置,代码如下:

    public class MainActivity extends AppCompatActivity {
    
        private Toolbar toolbar;
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
            
            toolbar = (Toolbar) findViewById(R.id.toolbar);
            toolbar.setTitle("Title");
            toolbar.setSubtitle("SubTitle");
            toolbar.setLogo(R.mipmap.ic_launcher);
            
            //设置导航图标要在setSupportActionBar方法之后
            setSupportActionBar(toolbar);
            toolbar.setNavigationIcon(R.mipmap.ic_drawer_home);
        }
    
    }
    

    结果如下:

    结果3.png
    如果你想修改标题和子标题的字体大小、颜色等,可以调用 setTitleTextColorsetTitleTextAppearancesetSubtitleTextColorsetSubtitleTextAppearance 这些API。当然,这些设置都是支持在xml布局中直接添加的,但是用的不是android:命名空间,而是自定义命名空间,如下所示:
    <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:toolbar="http://schemas.android.com/apk/res-auto"
        ...>
        <android.support.v7.widget.Toolbar
            ...
            toolbar:logo="@mipmap/ic_launcher"
            toolbar:title="Title"
            toolbar:subtitle="Sub Title"
            toolbar:titleTextColor="#ffffff">
        </android.support.v7.widget.Toolbar>
    </FrameLayout>
    

    三、添加菜单选项图标及点击事件

    1.添加菜单选项图标

    一般导航条,在其右侧都会有菜单选项,当然ToolBar也是支持自定义菜单的,首先我们在菜单文件中,修改如下:res/menu/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=".MainActivity">
        <item android:id="@+id/action_search"
            android:title="Search"
            android:icon="@mipmap/ic_search"
            app:showAsAction="ifRoom"/>
        <item android:id="@+id/action_notifications"
            android:title="notifications"
            android:icon="@mipmap/ic_notifications"
            app:showAsAction="ifRoom"/>
        <item android:id="@+id/action_settings"
            android:title="@string/action_settings"
            android:orderInCategory="100"
            android:icon="@mipmap/ic_launcher"
            app:showAsAction="never"/>
    </menu>
    

    这里用了这样一个熟悉:app:showAsAction="ifRoom"/"never",app是自定义的命名空间,因为我们的activity继承的是AppCompatActivity,是support v7包的,并不是原生sdk内部的,因此不能使用android:showAsAction,否则会报错。然后ifRoom表示有空间则显示,never表示从不显示,而是会通过overflowwindow显示。
    接着我们在Activity中,要重写onCreateOptionsMenu()方法,把这个菜单加载进去:

    @Overridepublic boolean onCreateOptionsMenu(Menu menu) { 
           getMenuInflater().inflate(R.menu.menu_main, menu);   
           return true;
    }
    

    2.添加点击事件

    菜单有了,我们要为菜单添加点击事件,这样菜单才会有实际用途,添加点击事件也很方便,可以这样操作:

    //设置导航图标、添加菜单点击事件要在setSupportActionBar方法之后
            setSupportActionBar(toolbar);
            toolbar.setNavigationIcon(R.mipmap.ic_drawer_home);
    
            toolbar.setOnMenuItemClickListener(new Toolbar.OnMenuItemClickListener() {
                @Override
                public boolean onMenuItemClick(MenuItem item) {
                    switch (item.getItemId()) {
                        case R.id.action_search:
                            Toast.makeText(MainActivity.this, "Search !", Toast.LENGTH_SHORT).show();
                            break;
                        case R.id.action_notifications:
                            Toast.makeText(MainActivity.this, "Notificationa !", Toast.LENGTH_SHORT).show();
                            break;
                        case R.id.action_settings:
                            Toast.makeText(MainActivity.this, "Settings !", Toast.LENGTH_SHORT).show();
                            break;
                    }
                    return true;
                }
            });
    

    结果如下:


    结果5.png

    可以看到,菜单选项图标正常显示,以及点击事件都正常触发,但是还有一点瑕疵的地方,那就是右上角的三个圆点,是黑色的,与图标格格不入,有没有什么办法改变它呢?答案是有的,可以通过添加样式改变,如下所示:

    <resources>
        <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
            ...
            <item name="android:textColorSecondary">#ffffff</item>
        </style>
    </resources>
    

    "android:textColorSecondary"属性对应的就是右上角三个圆点的颜色了。改变之后将会变成你要的颜色。

    四、其他样式修改

    修改Toolbar popup menu样式

    我们先点击右上角的三个点,会弹出一个popup menu,如下所示:


    结果6.png

    可以看到右上角的popup menu是白底黑字,那么有没有什么办法改变它的背景颜色,使菜单显示为黑底白字呢呢?答案是有的,我们可以这样设置:
    首先在styles.xml文件中,新建一个主题:

    <!-- toolbar弹出菜单样式 -->
    <style name="ToolbarPopupTheme" parent="@style/ThemeOverlay.AppCompat.Dark">   
         <item name="android:colorBackground">#000000</item>
    </style>
    

    可以看到这个主题的parent是直接继承自ThemeOverlay.AppCompat.Dark,是支持包的一个主题,并且我们在内部声明了“android:colorBackground”这个属性,我们只要更改这个属性就能变更菜单的背景颜色了。接下来我们在布局文件中引入这个主题,这也很简单,为toolbar添加额外的属性如下:

    toolbar:popupTheme="@style/ToolbarPopupTheme"
    

    这样,改几行代码即可修改popup menu的背景颜色了,如下面所示:


    结果7.png

    修改Toolbar popup menu 弹出位置

    我们可以看到,popup menu的位置是过于偏上的,我们还可以修改它的位置,使它处于Toolbar之下,这样看起来可能更美观:
    修改styles.xml文件如下:

    <style name="ToolbarPopupTheme" parent="@style/ThemeOverlay.AppCompat.Dark">    
        <item name="android:colorBackground">#000000</item>    
        <item name="actionOverflowMenuStyle">@style/OverflowMenuStyle</item> <!--新增一个item,用于控制menu-->
    </style>
    <style name="OverflowMenuStyle" parent="Widget.AppCompat.Light.PopupMenu.Overflow">   
         <item name="overlapAnchor">false</item>  <!--把该属性改为false即可使menu位置位于toolbar之下-->
    </style>
    

    效果如下图:


    结果8.png

    那么到目前为止,对于toolbar的相关使用意见讲述完毕,可以看出toolbar的灵活性很高,能自定义很多样式,我们平常开发也会遇到各种不同的样式,因此toolbar用于取代actionbar是非常合适的。以后如果还有遇到别的样式,我也会分享出来,谢谢。

    相关文章

      网友评论

      • 杨晓是大V:多谢大佬,受教啦
      • b0756759b9ef:大神,有没有源码下载地址呀,分享一下源码吧
      • b1bce1525743:你好!请教下怎么调整显示在toolbar上面的menu图标之间的间距,在实际手机上运行,发现间距太宽了,仅仅两个menu图标就占了将近一半的宽度,导致留给title,或者其他控件的空间太少了。
      • 梦想在前方_:为啥我的菜单项总是溢出
      • 初来乍到啊:我想问一下,这个可以放在底部吗
      • 一瞬间的浮华:<item name="android:textColorSecondary">@android:color/white</item>
        这个属性能改变右上角的三个圆点的颜色,但是subtitle的颜色也跟着改变是怎么回事,能只让一个改变吗?
      • 薅韭菜:<item name="android:textColorSecondary">#ffffff</item>

        这个属性 也会把 toolbar.setsubtitle(); 字体颜色改变
      • 随手纪念:写的很详细,有没有源码?
      • 西风多少恨_吹不散眉弯:受教了,谢谢!
        0534acc5fd99:@鲨鱼也疯狂 看了你说的才知道为什么不显示!
        鲨鱼也疯狂:第二个例子 设置完title,subTitle,导航图标以后,“”标题“ ”这两个字会覆盖掉title和subtitle,难道只有我测试的时候有问题?
        鲨鱼也疯狂:关于作者的第一个例子,我不相信toolbar的宽为wrap_content的时候会出现图片中的那种效果!
      • 修得养得梦得过得:基本上会用到的都写了,而且写的很准确!
        必须点个赞
      • 蒙伟:期待下一篇,“以后如果还有遇到别的样式,我也会分享出来”
      • 撒旦的平:真的非常有用,谢谢
      • Liekkas_BJ:请问 右侧menu按钮前面的放大镜和铃铛是怎么调出来的?
        f70cd6537153:@陈育 请问下menu那些item之间的间距是怎样去除呢?里面好似又padding东西?
        丶蓝天白云梦:@Liekkas_BJ 用menu菜单文件指定 请看3.1
      • 六边形战士:请问一下,menu那些item 点下去上下间距是怎样去除呢?里面好似又padding东西
        f70cd6537153:请问你的解决了吗?
      • 2860698d2edb:布局文件中加上toolbar属性 在哪个布局文件中请问?
        给點陽洸灿灡:请问如何动态操作menu,根据不同的场景显示不用的菜单?
        弹出的下来菜单,如何显示图标?
        丶蓝天白云梦:@AlphabetZhang 你好,问题能否描述得更详细一点呢?
      • parkbaird:有源码就跟完美了 作者麻烦你发下源码
        parkbaird: @陈育 写的真详细
        parkbaird: @陈育 不需要了 谢谢你的分享 我弄懂了
        丶蓝天白云梦:@lt南墙 留个邮箱,今晚发给你
      • parkbaird:多谢
        丶蓝天白云梦:@lt南墙 希望对你有帮助
      • e538d7692efa:很实用,谢了
      • 牛牛技术:棒👍
      • simonenfp:实用
      • 暖冬不暖:popwindow更灵活吧
        丶蓝天白云梦:@暖冬不暖 popwindow的确是比较灵活 ,但是toolbar是作为导航栏而使用的,两者适用场景不同吧
      • Chenstyle:厉害呀!

      本文标题:Android ToolBar 使用完全解析

      本文链接:https://www.haomeiwen.com/subject/ubidrttx.html