android.support.v7.widget.Toolbar 详解

我会带着你远行 2022-08-19 04:48 349阅读 0赞

最近对android.support.v7.widget.Toolbar 进行学习，顺便自己记录一下，以便加深理解。我们都知道android 3.0以后google官方推出了ActionBar的工具栏控件，但是虽然是官方的东西，却存在着不少的限制如,无法定制文字或者控制图片间距之类，不过现在我们已经看到曙光在招手了，2014年的IO大会上google推荐了让android开发者眼前一亮的Material design 设计语言，为此android 5.0系统官方提供了ToolBar，并且提供了supprot library用于向下兼容。ToolBar 可以说是一个升级版的ActionBar。ToolBar相比ActionBar最大的不同就是自由化了，不再像ActionBar那样受限制。这主要是因为我们可以把ToolBar当做一个布局控件ViewGroup来使用。下面我们就来学习一下ToolBar控件该如何使用。

现在gradle文件配置如下内容（要保证你的支持包已经更新material design哦）：

dependencies {
        compile 'com.android.support:appcompat-v7:23.0.1'
        compile 'com.android.support:design:23.1.1'
    }

要使用ToolBar首先我们要去掉ActionBar的主题风格，主要在res/values/style.xml和res/values-v21/style.xml(android 21API)

中配置如下内容：

res/values/style.xml和res/values-v21/style.xml

去掉ActionBar的主题最简单的方法就是Theme.AppCompat主题

别忘在android 5.0的style也得改成Theme.AppCompat主题

接下来我们在布局文件main\_activity.xml中加入v7支持包下ToolBar控件如下：

main\_activity.xml：

布局文件设置好后，我们在代码中获取该控件并替换ActionBar：

protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
            toolbar= (Toolbar) findViewById(R.id.toolbar);
            //用toolbar替换actionbar
            setSupportActionBar(toolbar);
        }

![SouthEast][]

运行效果图，太难看了，而且完全不知道哪里是toolbar，我们希望的是右边的效果图。嗯，那么接下来我们就一步一步实现右边的效果图

首先我们来认识一下几个属性，直接上图：

![SouthEast 1][]

我们从下往上说明：

1.navigationBarColor:这个是控制底部导航栏背景颜色的属性，而且仅在android 5.0以上版生效，低于API 21 版本无效。

2.windowBackground:顾名思义主视图窗体的背景颜色。

3.ToolBar:background:工具栏ToolBar的背景颜色，只需在布局文件设置即可

4.colorPrimaryDark:状态栏的背景颜色，在style.xml中设置

接下来，我们就需要对其进行配置了，首先我们先新建一个color.xml，颜色值均来自官方自动生成的模板：

<?xml version="1.0" encoding="utf-8"?>
    <resources>
        <color name="colorPrimary">#3F51B5</color>
        <color name="colorPrimaryDark">#303F9F</color>
        <color name="colorAccent">#FF4081</color>
        <color name="colorBackground">#ffffff</color>
    </resources>

我们在style.xml和布局文件中分别加入以上属性配置

style.xml:

<resources>
        
        <style name="AppTheme" parent="Theme.AppCompat">
            
            <item name="windowActionBar">false</item>
            <item name="windowNoTitle">true</item>
            
            <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
            
            <item name="android:windowBackground">@color/colorBackground</item>
        </style>
    </resources>

activity\_main.xml

<android.support.v7.widget.Toolbar
            android:id="@+id/toolbar"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:background="@color/colorPrimary"
            android:minHeight="?attr/actionBarSize"
      />

![SouthEast 2][]

嗯，还不错！预期的效果已经开始出现了。接下来我们继续来为toolbar添加图标和菜单以及标题。

我们先在java代码中添加logo，title 和 subtitle ：

//app logo
            toolbar.setLogo(R.mipmap.ic_android_white_24dp);
            //title
            toolbar.setTitle("  Material Design ToolBar");
            //sub title
            toolbar.setSubtitle("  ToolBar subtitle");
            //以上3个属性必须在setSupportActionBar(toolbar)之前调用
            setSupportActionBar(toolbar);
            //设置导航Icon，必须在setSupportActionBar(toolbar)之后设置
            toolbar.setNavigationIcon(R.mipmap.ic_menu_white_24dp);
            //添加菜单点击事件
            toolbar.setNavigationOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    Snackbar.make(toolbar, "Click setNavigationIcon", Snackbar.LENGTH_SHORT).show();
                }
            });

运行效果图如下：

![SouthEast 3][]

已经相当清晰了，就不过多说明了，对了，导航菜单的点击事件是通过toolbar.setNavigationOnClickListener设置的。

那么到这里与最终的效果图就差3个小菜单了，嗯，接着完善，首先我们需要在menu文件夹下的新建一个菜单文件menu\_main.xml(名称自定义即可)，然后在menu\_main.xml添加如下内容：

其中search菜单用的是 android.support.v7.widget.SearchView类

关于菜单详细内容这里就不过介绍，需要补一下知识的话可以看一下这篇文章[http://blog.csdn.net/ganlijianstyle/article/details/7566071][http_blog.csdn.net_ganlijianstyle_article_details_7566071]

声明完xml文件，我们需要在代码中重写onCreateOptionsMenu(Menu menu)方法如下代码：

/**
         * 该方法是用来加载菜单布局的
         * @param menu
         * @return
         */
        @Override
        public boolean onCreateOptionsMenu(Menu menu) {
            //加载菜单文件
            getMenuInflater().inflate(R.menu.menu_main, menu);
            return true;
        }

接下来，我们为菜单添加点击事件，这是可以通过Toolbar.OnMenuItemClickListener来设置监听事件

我们先创建Toolbar.OnMenuItemClickListener监听类：

private Toolbar.OnMenuItemClickListener onMenuItemClickListener=new Toolbar.OnMenuItemClickListener() {
            @Override
            public boolean onMenuItemClick(MenuItem menuItem) {
                switch (menuItem.getItemId()){
    //                case R.id.action_search://因为使用android.support.v7.widget.SearchView类，可以在
                                                onCreateOptionsMenu(Menu menu)中直接设置监听事件
    //                    Snackbar.make(toolbar,"Click Search",Snackbar.LENGTH_SHORT).show();
    //                    break;
                    case R.id.action_share:
                        Snackbar.make(toolbar,"Click Share",Snackbar.LENGTH_SHORT).show();
                        break;
                    case R.id.action_more:
                        Snackbar.make(toolbar,"Click More",Snackbar.LENGTH_SHORT).show();
                        break;
                }
                return true;
            }
        };

把监听器设置给toolbar：

toolbar.setOnMenuItemClickListener(onMenuItemClickListener);

到此监听事件就添加完成。我们运行程序，动态图如下：  
![SouthEast 4][]

好了，到此toolbar的基本用法已经介绍完了。下面我们介绍一下style.xml中其他属性：

<item name="colorAccent">@color/colorAccent</item>
     <item name="android:textColorPrimary">@color/textColorPrimary</item>
     <item name="colorControlNormal">#000000</item>
     <item name="colorControlHighlight">@color/colorControlHighlight</item>

1.colorAccent:这个属性是用于配置控件被选中时显示的颜色，eg:radio,checkBox等等。

2.textColorPrimary:Toolbar中的标题与小标题以及更多菜单中文字的颜色。

3.colorControlNormal:配置控件初始化显示时的颜色。

4.colorControlHighlight:配置点击控件时的效果颜色

5.colorControlActivated:点击控件(或者控件被选中)后显示的颜色，如果使用该属性，那么colorAccent的效果将被覆盖。

下面给出效果图：

![SouthEast 5][]

![SouthEast 6][]

![SouthEast 7][]

最后附上动态图：

![SouthEast 8][]

好了到此，都介绍完整了，下一篇我会结合侧滑菜单draglayout控件和导航Toolbar实现交换......

代码下载地址：[http://download.csdn.net/detail/javazejian/9388065][http_download.csdn.net_detail_javazejian_9388065]

参考文章：

http://www.cnblogs.com/noodlesonce/p/4116414.html?utm\_source=tuicool&utm\_medium=referral

[SouthEast]: /images/20220731/551d0bb9ebc04ba5967b1ca4c295acf0.png
[SouthEast 1]: /images/20220731/64dc0803002f42bfa37e5bd9d15d1bf3.png
[SouthEast 2]: /images/20220731/3bfc28940b97486b970c5c9a00e20ac3.png
[SouthEast 3]: /images/20220731/b0d740ec815a4ff294dc49ed376d9ead.png
[http_blog.csdn.net_ganlijianstyle_article_details_7566071]: http://blog.csdn.net/ganlijianstyle/article/details/7566071
[SouthEast 4]: /images/20220731/3897ffea9d724ed08672e296905ff8b1.png
[SouthEast 5]: /images/20220731/6723aa51dfcc405cb07782aeadd473ed.png
[SouthEast 6]: /images/20220731/ea139875b45143e3990454c580ed3fe7.png
[SouthEast 7]: /images/20220731/f91f1a54dba84dd787b494e632dab1cd.png
[SouthEast 8]: /images/20220731/47c555c6816c4fe69797148438226e7e.png
[http_download.csdn.net_detail_javazejian_9388065]: http://download.csdn.net/detail/javazejian/9388065