Android常用UI之Toolbar

转载请注明出处：http://blog.csdn.net/h_zhang/article/details/51232773

Android3.0之后引入了ActionBar控件，但是由于ActionBar操作的诸多不便，并且官方也在一定程度上承认ActionBar限制了android app设计与开发的弹性。所以google官方建议使用Toolbar代替ActionBar，Toolbar比ActionBar使用起来更加灵活。而在material design中也对其做了名称的定义：app bar。

app bar可以向用户提供非常熟悉的可视化结构和交互元素。使用app bar可以让用户快速了解怎样使用你的应用，这就给用户一个很好的体验。
应用程序中使用app bar可有如下优点：
1. 可以显示出用户所处的当前位置；
2. 可以提供一些重要的交互操作，比如搜索(search)操作；
3. 可以实现导航功能，让用户快速回到Home Activity；

本文就主要介绍一下Android Toolbar的使用方法。

---

设置Toolbar

即使再简单的Toolbar也应该具有两个元素，左边显示activity的标题，右边显示一个overflow菜单。为了让android 5.0以前也能使用Toolbar，我们得使用support v7包中的Toolbar来为activity设置toolbar。
设置Toolbar需要注意一下两点：
1. 你的Activity需要继承自AppCompatActivity
2. 你得先定义一个NoActionBar的主题，并让你的应用程序使用这个主题。这样做的目的是阻止你的应用程序使用本地ActionBar的功能。

下面贴一个示例程序：
首先看样式定义文件，values/styles.xml :

<resources>

    <!-- Base application theme. -->
    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <!-- Customize your theme here. -->
        <item name="colorPrimary">@color/colorPrimary</item>
        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
        <item name="colorAccent">@color/colorAccent</item>
    </style>

    <style name="AppTheme.NoActionBar">
        <item name="windowActionBar">false</item>
        <item name="windowNoTitle">true</item>
    </style>

    <style name="AppTheme.AppBarOverlay" parent="ThemeOverlay.AppCompat.Dark.ActionBar"/>

    <style name="AppTheme.PopupOverlay" parent="ThemeOverlay.AppCompat.Light"/>

</resources>

主要就是定义了一些主题，其中主题AppTheme中colorPrimary属性就指定了Toolbar的底色。colorPrimaryDark属性指定顶部状态栏的颜色。

接下来在activity布局文件中加上Toolbar的布局。
activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<android.support.design.widget.CoordinatorLayout
    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"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true"
    tools:context="cn.hebut.toolbar2.MainActivity">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <android.support.v7.widget.Toolbar
            android:id="@+id/toolbar"
            android:layout_width="match_parent"
            android:layout_height="?attr/actionBarSize"
            android:background="?attr/colorPrimary"
            android:theme="@style/AppTheme.AppBarOverlay"
            app:title="首页"
            app:logo="@mipmap/ic_launcher"
            app:popupTheme="@style/AppTheme.PopupOverlay"/>

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Hello World!"/>

    </LinearLayout>

</android.support.design.widget.CoordinatorLayout>

利用android.support.v7.widget.Toolbar定义了Toolbar的布局。通过app:title属性设置Toolbar的标题，通过app:logo属性设置Toolbar的图标。还可以通过app:titleTextColor属性设置标题文字颜色等等。

接着再看MainActivity.java中用代码如何设置Toolbar：

public class MainActivity extends AppCompatActivity
{

    @Override
    protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

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

    }

    @Override
    public boolean onCreateOptionsMenu(Menu menu)
    {
        getMenuInflater().inflate(R.menu.menu_main, menu);

        return true;
    }
}

代码相当简单，通过setSupportActionBar()方法将布局文件中的Toolbar设置进去就可以了。

在menu_main.xml布局文件中添加action按钮。
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="cn.hebut.toolbar2.MainActivity">

    <item
        android:id="@+id/action_setting"
        android:icon="@mipmap/ic_settings"
        android:title="设置"
        app:showAsAction="never"/>

</menu>

action按钮通过item标签设置。其中icon属性指定action按钮的图标，如果anction按钮在Toolbar中显示就显示该图标；title属性指定action按钮的名称，如果anction按钮在overflow中显示就显示title。注意，在overflow按钮中，系统默认只显示title，而不显示icon；最后showAsAction属性设置为”never”，表示该action按钮只在overflow按钮中显示，showAsAction属性还可以指定为ifRoom，ifRoom表示如果Toolbar中有空间，就在Toolbar中显示，如果Toolbar中没有足够的空间，就在overflow中显示。

下面是manifest文件：

<application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme.NoActionBar">
        <activity
            android:name=".MainActivity"
            android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>

                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
</application>

第6行，设置app的样式为AppTheme.NoActionBar，这样应用程序就可以阻止使用系统自带的ActionBar。

运行程序，得到如下效果：

上图中最右边的三个点就是overflow按钮。点击overflow会发现里面有个title为”设置”的action按钮。

---

响应action按钮点击事件

在menu_main.xml文件中添加几个action按钮；
menu_main.xml

<item
    android:id="@+id/action_search"
    android:icon="@mipmap/ic_search"
    android:title="搜索"
    app:showAsAction="ifRoom"/>
<item
    android:id="@+id/action_add"
    android:icon="@mipmap/ic_add"
    android:title="添加"
    app:showAsAction="ifRoom"/>
<item
    android:id="@+id/action_setting"
    android:icon="@mipmap/ic_settings"
    android:title="设置"
    app:showAsAction="never"/>

action按钮的事件响应主要在Activity中的onOptionsItemSelected()方法中实现，具体代码如下。
MainActivity.java :

public boolean onOptionsItemSelected(MenuItem item)
{
    switch (item.getItemId())
    {
        case R.id.action_search:
            Toast.makeText(MainActivity.this, "搜索", Toast.LENGTH_SHORT).show();
            break;
        case R.id.action_add:
            Toast.makeText(MainActivity.this, "添加", Toast.LENGTH_SHORT).show();
            break;
        case R.id.action_setting:
            Toast.makeText(MainActivity.this, "设置", Toast.LENGTH_SHORT).show();
            break;
    }

    return super.onOptionsItemSelected(item);
}

程序运行效果图：

---

添加导航按钮

导航按钮可以让用户很容易的返回app的主界面，这就能够产生非常好的用户体验。给Toolbar添加导航按钮功能也是非常简单的，通过如下两步即可：
1. 在manifest文件中通过android:parentActivityName属性为Activity配置parent activity
2. 在代码中通过ActionBar.setDisplayHomeAsUpEnabled(true)方法使能导航按钮

下面我们就来实现一下，先做一些准备工作。在首页增加一个按钮；
activity_main.xml :

 <android.support.v7.widget.Toolbar
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    android:background="?attr/colorPrimary"
    android:theme="@style/AppTheme.AppBarOverlay"
    app:title="首页"
    app:logo="@mipmap/ic_launcher"
    app:popupTheme="@style/AppTheme.PopupOverlay"/>

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="Hello World!"/>

<Button
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="child activity"
    android:onClick="start"/>

相当简单，就是增加了一个Button按钮，点击button执行start()方法。
MainActivity.java :

public void start(View view)
{
    Intent i = new Intent(this, ChildActivity.class);
    startActivity(i);
}

start()方法启动了一个child activity。
ChildActivity.java :

public class ChildActivity extends AppCompatActivity
{

    @Override
    protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_child);
        Toolbar toolbar = (Toolbar) findViewById(R.id.child_toolbar);
        setSupportActionBar(toolbar);
        ActionBar ab = getSupportActionBar();

        //使能app bar的导航功能
        ab.setDisplayHomeAsUpEnabled(true);
    }

    @Override
    public boolean onOptionsItemSelected(MenuItem item)
    {
        return super.onOptionsItemSelected(item);
    }

}

第11行，通过getSupportActionBar()方法得到ActionBar实例；第14行，调用ActionBar的setDisplayHomeAsUpEnabled()使能导航功能。

接下来看一下child activity的布局文件

<android.support.design.widget.CoordinatorLayout
    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"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true"
    tools:context="cn.hebut.toolbar3.MainActivity">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <android.support.v7.widget.Toolbar
            android:id="@+id/child_toolbar"
            android:layout_width="match_parent"
            android:layout_height="?attr/actionBarSize"
            android:background="?attr/colorPrimary"
            android:elevation="4dp"
            android:theme="@style/AppTheme.AppBarOverlay"
            app:title="childActivity"
            app:logo="@mipmap/ic_launcher"
            app:popupTheme="@style/AppTheme.PopupOverlay"/>

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:text="this is child activity!"
            android:textSize="22sp"/>

    </LinearLayout>

</android.support.design.widget.CoordinatorLayout>

没什么好说的。最后，在manifest文件中为ChildActivity指定parent Activity。

<activity
    android:name=".ChildActivity"
    android:label="@string/title_activity_child"
    android:parentActivityName=".MainActivity">

    <meta-data
        android:name="android.support.PARENT_ACTIVITY"
        android:value=".MainActivity"/>
</activity>

通过android:parentActivityName属性指定ChildActivity的parent Activity。注意：meta-data标签是为了兼容android 4.0或者更小的版本。

程序运行效果图：

最后需要注意一点：你不需要对导航按钮的点击事件做出响应。因为点击导航按钮的响应事件，父类已经已经实现好了，你只需要调用父类方法即可。代码如下：

public boolean onOptionsItemSelected(MenuItem item)
{
    return super.onOptionsItemSelected(item);
}

---

添加Action View

Action View和Action按钮大致类似，都是为了通过Toolbar和用户进行交互操作。不过Action View提供了更加丰富的功能。举个例子：一个搜索功能的Action View可以让用户实现搜索操作，并且这个操作就在Toolbar中完成，而不需要切换activity或者fragment。support v7包中提供了很多现成的Action View，其中就包括SearchView，用来实现搜索功能。下面我们来实现一下。

添加一个Action View只需要在menu_main.xml中为item标签添加actionViewClass属性即可。
menu_main.xml:

<item
    android:id="@+id/action_search"
    android:icon="@mipmap/ic_search"
    android:title="搜索"
    app:showAsAction="ifRoom|collapseActionView"
    app:actionViewClass="android.support.v7.widget.SearchView"/>

actionViewClass属性指定为support v7包下SearchView；showAsAction指定为ifRoom|collapseActionView，其中collapseActionView表示：如果用户没有和action view交互，该Action view该如何在Toolbar中显示。

下面贴一下效果：

可以看到，如果用户不点击Action View，Action View将会和普通Action按钮一样；如果用户点了Action View的icon，Action View将会展开填充整个Toolbar。

你还可以在代码中对SearchView的属性就行配置，这些工作主要在Activity的onCreateOptionsMenu()方法中实现。

public boolean onCreateOptionsMenu(Menu menu)
{
    getMenuInflater().inflate(R.menu.menu_main, menu);

    MenuItem searchItem = menu.findItem(R.id.action_search);
    SearchView searchView = (SearchView) MenuItemCompat.getActionView(searchItem);
    //配置searchView...

    return true;
}

有的时候应用程序需要在Action View展开与合并的时候显示不同的界面。这时程序就可以对Action View的展开与合并进行监听。

public boolean onCreateOptionsMenu(Menu menu)
{
    getMenuInflater().inflate(R.menu.menu_main, menu);

    MenuItem searchItem = menu.findItem(R.id.action_search);

    //定义一个监听器
    OnActionExpandListener expandListener = new OnActionExpandListener()
    {
        @Override
        public boolean onMenuItemActionExpand(MenuItem item)
        {
            Toast.makeText(MainActivity.this, "expand", Toast.LENGTH_SHORT).show();
            return true;
        }

        @Override
        public boolean onMenuItemActionCollapse(MenuItem item)
        {
            Toast.makeText(MainActivity.this, "collapse", Toast.LENGTH_SHORT).show();
            return true;
        }
    };

    //设置监听器
    MenuItemCompat.setOnActionExpandListener(searchItem, expandListener);

    return true;
}

下面给个效果图：

---

添加Action Provider

Action Provider的功能就更加丰富了，Action Provider可以使用自定义布局。一个Action Provider初始状态也和Action按钮相似，可以显示在Toolbar中，也可以显示在Overflow按钮中。当用户点击Action Provider，用户可以按照自己想要的方式控制点击的响应事件。比如说，点击Action Provider后，用户可以展示一个子菜单。

下面我们自定义一个简单的Action Provider用于展示子菜单功能。

使用Action Provider很简单，只需要在menu资源文件中的item标签设置app:actionProviderClass属性即可：

menu_main.xml:

<item
    android:id="@+id/action_add"
    android:icon="@mipmap/ic_add"
    android:title="添加"
    app:showAsAction="ifRoom"
    app:actionProviderClass="cn.hebut.toolbar2.MyActionProvider"/>

可以看到actionProviderClass设置了一个自定义的MyActionProvider。下面我们来看如果自定义ActionProvider：

public class MyActionProvider extends ActionProvider
{
    public MyActionProvider(Context context)
    {
        super(context);
    }

    @Override
    public View onCreateActionView()
    {
        return null;
    }

    @Override
    public void onPrepareSubMenu(SubMenu subMenu)
    {
        subMenu.clear();

        subMenu.add("sub item 1")
                .setIcon(R.mipmap.ic_launcher)
                .setOnMenuItemClickListener(new MenuItem.OnMenuItemClickListener()
                {
                    @Override
                    public boolean onMenuItemClick(MenuItem item)
                    {
                        return true;
                    }
                });
        subMenu.add("sub item 2")
                .setIcon(R.mipmap.ic_launcher)
                .setOnMenuItemClickListener(new MenuItem.OnMenuItemClickListener()
                {
                    @Override
                    public boolean onMenuItemClick(MenuItem item)
                    {
                        return true;
                    }
                });
    }

    @Override
    public boolean hasSubMenu()
    {
        return true;
    }
}

我们定义了MyActionProvider类并继承ActionProvider。为了表示这个Action Provider有子菜单，需要重写hasSubMenu()方法并返回true。然后在onPrepareSubMenu()方法中通过SubMenu的add()方法添加子菜单。

好，最后我们看一下自定义ActionProvider的执行效果图：

可以发现，这个自定义ActionProvier的功能和overflow很相似。

---

OK，关于Android的Toolbar的使用用法就说这么多，相信通过对本篇文章的学习，大家基本能掌握Toolbar的使用方法了。

参考文章：
Android Developers: http://developer.android.com/intl/zh-cn/training/appbar/index.html
郭霖大神的文章：http://blog.csdn.net/guolin_blog/article/details/18234477