android：ToolBar详解（手把手教程）(转)

来源 http://blog.mosil.biz/2014/10/android-toolbar/

编辑推荐：稀土掘金，这是一个针对技术开发者的一个应用，你可以在掘金上获取最新最优质的技术干货，不仅仅是Android知识、前端、后端以至于产品和设计都有涉猎，想成为全栈工程师的朋友不要错过！

这篇文章因为是台湾人写的，语言风格很别致。本文在原文的基础上做了一些微调（主要是繁体字的问题）。

今年(2014) 的 google i/o 发表令多数人为之一亮的 material design，而 google 也从「google i/o 2014」 开始，大家也陆陆续续地看到其更新的 android app 皆套用了这个设计介面。当然，这个设计介面著实让大家感到惊艳外，更让 android 开发者开始担心未来 app 的界面处理了。

不过，所幸有着之前 actionbar 的经验后，android 也很快地在 support library 里面提供了相对应的 api 给开发者使用，本篇就为各位介绍 – toolbar，这是用来取代过去 actionbar 的控件，而现在于 material design 中也对之有一个统一名称：app bar，在未来的 android app 中，就以 toolbar 这个元件来实作之。

1. 概述

Android 3.0  Android 推了 ActionBar 这个控件，而到了2013 年 Google 开始大力地推动所谓的 android style，想要逐渐改善过去 android 纷乱的界面设计，希望让终端使用者尽可能在 android 手机有个一致的操作体验。ActionBar 过去最多人使用的两大套件就是 ActionBarSherlock 以及官方提供在 support library v 7 里的 AppCompat。

既然会有本篇跟各位介绍的 Toolbar，也意味着官方在某些程度上认为 ActionBar 限制了 android app 的开发与设计的弹性，而在 material design 也对之做了名称的定义：App bar。接下来将为各位分成几个阶段进行说明，如何在 android app 中用 toolbar 这个控件来做出一个基本的 app bar 喽。

本篇所使用到的程序请到 Github 取得。

2. 基础套用

这个阶段从 toolbar_demo_checkpoint0 开始，分成下列三个部份：

风格 (style)
界面 (layout)
程序 (java)

2.1 风格(style)

风格要调整的地方有二

一在 res/values/styles.xml中

二在 /res/values-v21/styles.xml中

为了之后设定方便，我们先在 res/values/styles.xml 里增加一个名为 AppTheme.Base 的风格

  1. <style name="AppTheme.Base" parent="Theme.AppCompat">
  2. <item name="windowActionBar">false</item>
  3. <item name="android:windowNoTitle">true</item>
  4. </style>

因为此范例只使用 Toolbar，所以我们要将让原本的 ActionBar 隐藏起来，然后将原本 AppTheme 的 parent 属性 改为上面的AppTheme.Base，代码如下：

  1. <resources>
  2. <!-- Base application theme. -->
  3. <style name="AppTheme" parent="AppTheme.Base">
  4. </style>
  5. <style name="AppTheme.Base" parent="Theme.AppCompat">
  6. <item name="windowActionBar">false</item>
  7. <del><item name="android:windowNoTitle">true</item></del>
  8. <!-- 使用 API Level 22 編譯的話，要拿掉前綴字 -->
  9. <item name="windowNoTitle">true</item>
  10. </style>
  11. </resources>

再来调整Android 5.0的style：  /res/values-v21/styles.xml，也将其 parent 属性改为  AppTheme.Base：

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <resources>
  3. <style name="AppTheme" parent="AppTheme.Base">
  4. </style>
  5. </resources>

2.2  界面(Layout)

在 activity_main.xml 里面添加 Toolbar 控件：

  1. <android.support.v7.widget.Toolbar
  2. android:id="@+id/toolbar"
  3. android:layout_height="?attr/actionBarSize"
  4. android:layout_width="match_parent" >
  5. </android.support.v7.widget.Toolbar>

请记得用 support v7 里的 toolbar，不然然只有 API Level 21 也就是 Android 5.0 以上的版本才能使用。

这里需注意，要将 RelatvieLayout 里的四个方向的padding 属性去掉，并记得将原本的 Hello World 设为 layout_below="@+id/toolbar" ，否则会看到像下面这样的错误画面。

2.3 程序 (Java)

在 MainActivity.java 中加入 Toolbar 的声明：

  1. Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
  2. setSupportActionBar(toolbar);

声明后，再将之用 setSupportActionBar 设定，Toolbar即能取代原本的 actionbar 了，此阶段完成画面如下：

完整代码见：toolbar_demo_checkpoint1

3. 自定义颜色(Customization color)

这个阶段将从 toolbar_demo_checkpoint1 接着往下进行：

上图是将本阶段要完成的结果画面做了标示，结合下面的描述希望大家能明白。

  1. colorPrimaryDark（状态栏底色）：在风格 (styles) 或是主题 (themes) 里进行设定。
  2. App bar 底色

    这个设定分为二，若你的 android app 仍是使用 actionbar ，则直接在风格 (styles) 或是主题 (themes) 里进行设定 colorPrimary 参数即可；
    可若是采用 toolbar 的话，则要在界面 (layout) 里面设定 toolbar 控件的 background 属性。

  3. navigationBarColor（导航栏底色）：

仅能在 API v21 也就是 Android 5 以后的版本中使用， 因此要将之设定在 res/values-v21/styles.xml 里面。

  1. 主视窗底色：windowBackground

也因此在这个阶段，我们需要设定的地方有三，一是 style中(res/values/styles.xml)

  1. <style name="AppTheme.Base" parent="Theme.AppCompat">
  2. <item name="windowActionBar">false</item>
  3. <item name="android:windowNoTitle">true</item>
  4. <!-- Actionbar color -->
  5. <item name="colorPrimary">@color/accent_material_dark</item>
  6. <!--Status bar color-->
  7. <item name="colorPrimaryDark">@color/accent_material_light</item>
  8. <!--Window color-->
  9. <item name="android:windowBackground">@color/dim_foreground_material_dark</item>
  10. </style>

再来是 v21 的style中 (res/values-v21/styles.xml)

  1. <style name="AppTheme" parent="AppTheme.Base">
  2. <!--Navigation bar color-->
  3. <item name="android:navigationBarColor">@color/accent_material_light</item>
  4. </style>

最后，就是为了本篇的主角 – Toolbar 的 background 进行设定。

  1. <android.support.v7.widget.Toolbar
  2. android:id="@+id/toolbar"
  3. android:layout_height="?attr/actionBarSize"
  4. android:layout_width="match_parent"
  5. android:background="?attr/colorPrimary" >
  6. </android.support.v7.widget.Toolbar>

在本范例中，toolbar 是设定来在 activity_main.xml，对其设定 background 属性： android:background="?attr/colorPrimary" ，这样就可以使之延用 Actionbar 的颜色设定喽。

最后，再来看一下结果画面。

完整代码见： toolbar_demo_checkpoint2

4. 控件 (component)

本阶段将从 toolbar_demo_checkpoint2 接续，在还未于 <android.support.v7.widget.Toolbar/>  标签中，自行添加元件的 toolbar 有几个大家常用的元素可以使用，请先见下图：

大抵来说，预设常用的几个元素就如图中所示，接着就依序来说明之：

  1. setNavigationIcon
    即设定 up button 的图标，因为 Material 的介面，在 Toolbar这里的 up button样式也就有別于过去的 ActionBar 哦。
  1. setLogo
    APP 的图标。
  2. setTitle
    主标题。
  3. setSubtitle
    副标题。
  4. setOnMenuItemClickListener
    设定菜单各按鈕的动作。

先来看看菜单外的代码，在 MainActivity.java 中：

  1. Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
  2. // App Logo
  3. toolbar.setLogo(R.drawable.ic_launcher);
  4. // Title
  5. toolbar.setTitle("My Title");
  6. // Sub Title
  7. toolbar.setSubtitle("Sub title");
  8. setSupportActionBar(toolbar);
  9. // Navigation Icon 要設定在 setSupoortActionBar 才有作用
  10. // 否則會出現 back button
  11. toolbar.setNavigationIcon(R.drawable.ab_android);

这边要留意的是setNavigationIcon需要放在 setSupportActionBar之后才会生效。

菜单部分，需要先在res/menu/menu_main.xml左定义：

  1. <menu xmlns:android="http://schemas.android.com/apk/res/android"
  2. xmlns:app="http://schemas.android.com/apk/res-auto"
  3. xmlns:tools="http://schemas.android.com/tools"
  4. tools:context=".MainActivity">
  5. <item android:id="@+id/action_edit"
  6. android:title="@string/action_edit"
  7. android:orderInCategory="80"
  8. android:icon="@drawable/ab_edit"
  9. app:showAsAction="ifRoom" />
  10. <item android:id="@+id/action_share"
  11. android:title="@string/action_edit"
  12. android:orderInCategory="90"
  13. android:icon="@drawable/ab_share"
  14. app:showAsAction="ifRoom" />
  15. <item android:id="@+id/action_settings"
  16. android:title="@string/action_settings"
  17. android:orderInCategory="100"
  18. app:showAsAction="never"/>
  19. </menu>

再回到MainActivity.java 中加入OnMenuItemClickListener 的监听者：

  1. private Toolbar.OnMenuItemClickListener onMenuItemClick = new Toolbar.OnMenuItemClickListener() {
  2. @Override
  3. public boolean onMenuItemClick(MenuItem menuItem) {
  4. String msg = "";
  5. switch (menuItem.getItemId()) {
  6. case R.id.action_edit:
  7. msg += "Click edit";
  8. break;
  9. case R.id.action_share:
  10. msg += "Click share";
  11. break;
  12. case R.id.action_settings:
  13. msg += "Click setting";
  14. break;
  15. }
  16. if(!msg.equals("")) {
  17. Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
  18. }
  19. return true;
  20. }
  21. };

将onMenuItemClick监听者设置给toolbar

  1. setSupportActionBar(toolbar);
  2. ...
  3. // Menu item click 的監聽事件一樣要設定在 setSupportActionBar 才有作用
  4. toolbar.setOnMenuItemClickListener(onMenuItemClick);

和 setNavigationIcon 一样，需要將之设定在 setSupportActionBar 之后才有作用。执行上面的代码便会得到下面的界面。

完完整程序见：toolbar_demo_checkpoint3

5. 总结

在这样的架构设计下，ToolBar直接成了Layout中可以控制的东西，相对于过去的actionbar来说，设计与可操控性大幅提升。

本文上面的解释中用到的完成代码：toolbar demo check point 0 ~ 4，请到Github 取得。

最后再附上一个界面上常用的属性说明图：

这里按照图中从上到下的顺序做个简单的说明：

    • colorPrimaryDark
      • 状态栏背景色。
      • 在 style 的属性中设置。
    • textColorPrimary
      • App bar 上的标题与更多菜单中的文字颜色。
      • 在 style 的属性中设置。
    • App bar 的背景色
      • Actionbar 的背景色设定在 style 中的 colorPrimary。
      • Toolbar 的背景色在layout文件中设置background属性。
    • colorAccent
      • 各控制元件(如：check box、switch 或是 radoi) 被勾选 (checked) 或是选定 (selected) 的颜色。
      • 在 style 的属性中设置。
    • colorControlNormal
      • 各控制元件的预设颜色。
      • 在 style 的属性中设置
    • windowBackground
      • App 的背景色。
      • 在 style 的属性中设置
    • navigationBarColor
      • 导航栏的背景色，但只能用在 API Level 21 (Android 5) 以上的版本
      • 在 style 的属性中设置

最后需要注意的是：使用material主题的时候，必须设定targetSdkVersion = 21，否则界面看起来是模糊的

时间： 2024-08-24 17:22:58

android：ToolBar详解（手把手教程）(转)的相关文章

Android ToolBar详解

今年(2014) 的 google i/o 发表令多数人为之一亮的 material design,而 google 也从「google i/o 2014」 开始,大家也陆陆续续地看到其更新的 android app 皆套用了这个设计介面.当然,这个设计介面著实让大家感到惊艳外,更让 android 开发者开始担心未来 app 的界面处理了.不过,所幸有着之前 actionbar 的经验后,android 也很快地在 support library 里面提供了相对应的 api 给开发者使用,本篇

Android ijkplayer详解使用教程

1.认识ijkplayer 最近公司准备开发一款视频播放及直播的应用,找了许多开源的框架,大部分都是基于ffmpeg开发的.最开始准备用Vitamio框架开发的,相关的文章也比较丰富,结果对于非个人移动应用均需购买Vitamio使用授权.不过B站开源的ijkplayer也不错,而且也不需要商业授权. ijkplayer是一个基于FFmpeg的轻量级Android/iOS视频播放器.FFmpeg的是全球领先的多媒体框架,能够解码,编码, 转码,复用,解复用,流,过滤器和播放大部分的视频格式.它提供

android：ToolBar详解

这篇文章因为是台湾人写的,语言风格很别致.本文在原文的基础上做了一些微调(主要是繁体字的问题). 今年(2014) 的 google i/o 发表令多数人为之一亮的 material design,而 google 也从「google i/o 2014」 开始,大家也陆陆续续地看到其更新的 android app 皆套用了这个设计介面.当然,这个设计介面著实让大家感到惊艳外,更让 android 开发者开始担心未来 app 的界面处理了. 不过,所幸有着之前 actionbar 的经验后,and

Android菜单详解——理解android中的Menu

Android菜单详解--理解android中的Menu 前言 今天看了pro android 3中menu这一章,对Android的整个menu体系有了进一步的了解,故整理下笔记与大家分享. PS:强烈推荐<Pro Android 3>,是我至今为止看到的最好的一本android书,中文版出到<精通Android 2>. 理解Android的菜单 菜单是许多应用程序不可或缺的一部分,Android中更是如此,所有搭载Android系统的手机甚至都要有一个"Menu&qu

[gitbook] Android框架分析系列之Android Binder详解

请支持作者原创: https://mr-cao.gitbooks.io/android/content/android-binder.html Android Binder详解 Table of Contents 1. binder简介 2. binder的实现 2.1. IBinder类简介 2.2. IInterface类简介 2.3. BpBinder和BBinder简介 2.4. ProcessState和IPCThreadState简介 2.5. ServiceManager简介 2.

android动画详解三 动画API概述

· 属性动画与view动画的不同之处 view动画系统提供了仅动画View 对象的能力,所以如果你想动画非View 对象,你就要自己实现代码. view动画系统实际上还被强制仅能对 View 的少数属性进行动画,比如缩放和旋转,而不能对背景色进行. view动画的另一个坏处是它仅修改View的绘制位置,而不是View的实际位置.例如,如果你动画一个移动穿越屏幕,button的绘制位置是正确的,但实际你可以点击它的位置却没有变,所以你必须去实现你自己的逻辑来处理它. 使用属性动画系统时,这个限制被

android矩阵详解

Matrix,中文里叫矩阵,高等数学里有介绍,在图像处理方面,主要是用于平面的缩放.平移.旋转等操作. 在Android里面,Matrix由9个float值构成,是一个3*3的矩阵.最好记住.如下图: 解释一下,上面的sinX和cosX,表示旋转角度的cos值和sin值,注意,旋转角度是按顺时针方向计算的. translateX和translateY表示x和y的平移量.scale是缩放的比例,1是不变,2是表示缩放1/2,这样子. 在android.graphics.Matrix中有对应旋转的函

Android ProgressBar详解以及自定义

版本:1.0 日期:2014.5.16 版权:© 2014 kince 转载注明出处 这一次主要说一下Android下的进度条,为什么是它呢,因为近期被其各种美轮美奂的设计所倾倒,计划逐渐去实现.另外一个因素也是它也是为数不多的直接继承于View类的控件,从中可以学习到一些自定义控件的知识.下面列举了一些个人觉得还算漂亮的进度条,仅供参考. 是不是很漂亮,其实就像上面图形展示的那样,进度条大体上无非就是这几种形式.这样一来肯定是需要自定义了,所以方向有两个:要么继承于系统的ProgressBar

Android 菜单详解

Android中菜单分为三种,选项菜单(OptionMenu),上下文菜单(ContextMenu),子菜单(SubMenu) 选项菜单 可以通过两种办法增加选项菜单,一是在menu.xml中添加,该种方式参见Android 资源详解(二) 菜单资源,二是在.java中添加 1.覆盖Activity 的 onCreateOptionsMenu(Menu  menu)方法,当我们第一次打开菜单 时该方法被自动调用. 2.调用Menu的 add()方法添加菜单项(Menultem) ,可以调用Men

Android菜单详解（一）——理解android中的Menu

前言 今天看了pro android 3中menu这一章,对Android的整个menu体系有了进一步的了解,故整理下笔记与大家分享. PS:强烈推荐<Pro Android 3>,是我至今为止看到的最好的一本android书,中文版出到<精通Android 2>. 理解Android的菜单 菜单是许多应用程序不可或缺的一部分,Android中更是如此,所有搭载Android系统的手机甚至都要有一个"Menu"键,由此可见菜单在Android程序中的特殊性.An