Toolbar使用详解

作者: DoAndKeep | 来源:发表于2016-08-07 18:36 被阅读20482次

    Toobar与ActionBar

    从Android3.0(API level 11)开始,所有使用默认主题的activity都自带一个ActionBar,但是随着Android版本的迭代,ActionBar的特性不断增加,从而导致了在不同Android系统的设备上,ActionBar的显示不一致。

    从Android5.0(API level 21)开始,引进了Toolbar,它包含了ActionBar最近添加的大多数特性,同时添加到了支持库中,使得在低版本设备上也可以使用Toolbar。

    Toolbar与ActionBar的区别:

    • ToolBar就是一个View,跟其它View一样包含在布局中。
    • 像常规View一样,Toolbar很容易来放置、实现动画以及控制。
    • 一个Activity中可以有多个Toolbar。

    Toolbar是简单使用

    1. 在应用的build.gradle中添加v7 appcompat支持库。
    com.android.support:appcompat-v7:24.1.1
    
    1. 让Activity继承自AppCompatActivity。
    public class MyActivity extends AppCompatActivity {
        // ...
    } 
    
    1. 在AndroidManifest.xml文件中,设置<application>元素使用appcompat中的某个NoActionBar主题,从而来去除使用ActionBar来提供操作栏。
    <application
            android:theme="@style/Theme.AppCompat.Light.NoActionBar"/>
    
    1. 在activity的布局中添加Toolbar。
    <android.support.v7.widget.Toolbar
       android:id="@+id/my_toolbar"
       android:layout_width="match_parent"
       android:layout_height="?attr/actionBarSize"
       android:background="?attr/colorPrimary"
       android:elevation="4dp"
       android:theme="@style/ThemeOverlay.AppCompat.ActionBar"  
       app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
    
    1. 在activity的onCreate()方法中,调用setSupportActionBar()方法,并传入toolbar,这样就会将toolbar设置为activity的操作栏了。
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my);
        Toolbar toolbar = (Toolbar) findViewById(R.id.my_toolbar);
        setSupportActionBar(toolbar);
    }
    

    运行之后,效果图如下:

    Toolbar简单使用.png

    至此,activity有了一个基本的操作栏。可以通过获取的toolbar的引用,调用相关API来实现更多操作,例如隐藏或显示操作栏。

    Toolbar元素

    上面的效果图中,只显示了App的名称,但是Toolbar可以包含以下元素:

    • 导航按钮
    • 应用的Logo
    • 标题和子标题
    • 若干个自定义View
    • 动作菜单

    好的,接下来我们就让它们全部显示出来。

    1. 显示导航按钮、应用的Logo、标题和子标题。
    // 显示应用的Logo
    getSupportActionBar().setDisplayShowHomeEnabled(true);
    getSupportActionBar().setDisplayUseLogoEnabled(true);
    getSupportActionBar().setLogo(R.mipmap.ic_launcher);
    
    // 显示标题和子标题  
    getSupportActionBar().setDisplayShowTitleEnabled(true);
    toolbar.setTitle("ToolbarDemo");
    toolbar.setSubtitle("the detail of toolbar");
    // 显示导航按钮
    toolbar.setNavigationIcon(R.drawable.icon_back);
    
    1. 显示动作菜单。
      首先在res/menu目录下的xml文件中定义的,要添加几个动作,则在<menu>节点下添加几个item。
    <?xml version="1.0" encoding="utf-8"?>
    <menu 
       xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:app="http://schemas.android.com/apk/res-auto">
    
        <item
            android:id="@+id/toolbar_action1"
            android:icon="@drawable/icon_weibo_timeline_mine"
            android:title="Action"
            app:showAsAction="always"/>
    
        <item
            android:id="@+id/toolbar_action1"
            android:icon="@drawable/icon_weibo_timeline_mine"
            android:title="Action"
            app:showAsAction="never"/>
    
      </menu>
    

    item的icon和title属性顾名思义,而app:showAsAction属性则是用来指定这个动作是放置在操作栏上,还是溢出菜单中。当它的值设置为”ifRomom”时,如果操作栏有空间放置,则放置在操作栏上,否则放置到溢出菜单中。当它的值设置为”always”,这个动作将总是放置在操作栏上。当它的值设置为”never”,这个动作将总是放置在溢出菜单中。

    之后重写activity的onCreateOptionsMenu()方法,设置显示的menu资源:

    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        getMenuInflater().inflate(R.menu.menu_toolbar_demo, menu);
        return true;
    }
    

    当点击了按钮,可以通过重写activity的onOptionsItemSelected()方法来进行处理:

      @Override
      public boolean onOptionsItemSelected(MenuItem item) {
          switch (item.getItemId()) {
              case R.id.toolbar_action1:
                  // do something
                  return true;
              default:
                  // If we got here, the user's action was not recognized.
                  // Invoke the superclass to handle it.
                  return super.onOptionsItemSelected(item);
    
          }
      }
    
    1. 显示自定义View

    因为Toolbar是ViewGroup的子类,因此可以向其内部添加View进行显示。这里我们简单的添加一个TextView显示一个文本。

    <android.support.v7.widget.Toolbar
      android:id="@+id/toolbar"
      xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto"
      android:layout_width="match_parent"
      android:layout_height="?attr/actionBarSize"
      android:background="?attr/colorPrimary"
      android:elevation="4dp"
      android:theme="@style/ToolbarTheme"
      app:popupTheme="@style/ThemeOverlay.AppCompat.Light"
      app:titleTextAppearance="@style/Toolbar.TitleText">
    
      <TextView
          android:id="@+id/toolbar_title"
          style="@style/TextAppearance.AppCompat.Widget.ActionBar.Title"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:layout_gravity="center"
          android:text="自定义"
          android:textSize="21sp"/>
    
    </android.support.v7.widget.Toolbar>
    

    好了,所有的元素都添加到了Toolbar上,运行效果图如下:

    Toolbar元素

    Toolber复用

    应用中有很多界面,每个Activity一般都需要操作栏,且大多数activity的操作栏的元素是一致的,那每个布局文件里面都写这么多资源文件是累赘的。因此可以对Toolbar进行复用,使得布局文件看起来更精炼,更改Toolbar整体效果,如背景之类的可以更方便。

    首先,在布局文件toolbar.xml中定义Toolbar。

    <android.support.v7.widget.Toolbar
        android:id="@+id/toolbar"
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:layout_width="match_parent"
        android:layout_height="?attr/actionBarSize"
        android:background="?attr/colorPrimary"
        android:contentInsetLeft="0dp"
        android:contentInsetStart="0dp"
        android:elevation="4dp"
        android:theme="@style/ToolbarTheme"
        app:navigationIcon="@drawable/icon_back"
        app:popupTheme="@style/ThemeOverlay.AppCompat.Light"
        app:titleTextAppearance="@style/Toolbar.TitleText">
    
        <!--  any custom view -->
    
    </android.support.v7.widget.Toolbar>
    

    之后,在需要添加Toolbar的地方引入这个布局资源。

    <include
      layout="@layout/toolbar"/>
    

    最后,在BaseActivity(一般app都会有)中的onCreate()方法设置Toolbar。注意,这个时候Activity不再继承AppCompatActivity,而是继承BaseActivity,而BaseActivity继承AppCompatActivity。BaseActivity部分代码如下:

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    
        Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
        if (toolbar != null) {
            setSupportActionBar(toolbar);
    
            mToolbarHelper = new ToolbarHelper(toolbar);
    
            hanldeToolbar(mToolbarHelper);
        }
    }
    
    protected void hanldeToolbar(ToolbarHelper toolbarHelper) {}
    
    public static class ToolbarHelper {
    
        private Toolbar mToolbar;
    
        public ToolbarHelper(Toolbar toolbar) {
            this.mToolbar = toolbar;
        }
    
        public Toolbar getToolbar() {
            return mToolbar;
        }
    
        public void setTitle(String title) {
            TextView titleTV = (TextView) mToolbar.findViewById(R.id.toolbar_title);
            titleTV.setText(title);
        }
    }
    
    

    代码中首先获取到Toolbar将其设置为操作栏,之后创建了一个ToolbarHelper对象,ToobarHelper主要是封装了下Toolbar,并提供操作自定义View的方法。然后调用hanldeToolbar()方法,子Activity通过重写这个方法,可以对Toolbar进行定制操作。

    在真实项目中应用Toolbar

    在上面我们看到了显示所有Toolbar元素的效果图,肯定会说,这跟我们产品设计的不一样,跟应用中所需要的不一样。一般我们应用中大多是这样的:

    常用Toolbar.png

    观察下,首先左边是一个返回按钮,中间是标题,有可能右边是文本或者按钮来提供分享、编辑之类的操作。接下来,我们来看看如何实现。

    1. 实现返回按钮,在之前我们设置过显示导航按钮、logo、标题及子标题。现在将导航按钮作为返回按钮,设置为UI提供的图标,而logo和标题类的设置不显示就可以了。

    接下来就是设置事件监听了,还记得添加按钮时的事件处理么?一样的都是在onOptionsItemSelected()进行处理,它的id是android.R.id.home:

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
      switch (item.getItemId()) {
          case android.R.id.home:
              FragmentManager fm = getSupportFragmentManager();
              if (fm != null && fm.getBackStackEntryCount() > 0) {
                  fm.popBackStack(null, FragmentManager.POP_BACK_STACK_INCLUSIVE);
              } else {
                  finish();
              }
              return true;
          default:
              return super.onOptionsItemSelected(item);
      }
    }
    
    1. 实现中间标题的显示。在上一步我们禁用了Toolbar原本显示在左边的标题,中间的标题我们可以通过向Toolbar中添加TextView实现,与之前显示Toolbar上所有元素中的自定义View是一样的。对于更改标题,则通过上面Toolbar复用所提到的ToolbarHelper进行操作。
    2. 右边的文本及图标显示。这个可以使用Toolbar本身的menu(前面已经介绍过),也可以将其作为自定义View。

    总之,这三部分(左边+中间+右边)实现方式大致如此,根据你的项目,合理地进行安排。

    最后,附上源码地址:
    https://github.com/FILWAndroid/DevJourney

    关于源码:

    1. 不只是本文涉及的代码,会包含很多知识点的代码,应该都会在我的简书中进行介绍。
    2. 有可能代码与本文中所贴出来的有差异,但应该都是我觉得更好的方式吧。
    3. 欢迎大家对我进行批评教育。

    相关文章

      网友评论

      • f86f976115c3:这个有返回按钮的情况下,标题向右偏移怎么破。toolbar有加一句app:contentInsetStart=0这句
      • 低调小鱼鱼:写的很详细,非常用心。感谢分享
      • 修得养得梦得过得:最 -> 白色的3个小点咋弄的?我的咋是黑色的...
        ilovehusky:@修得养得梦得过得 应该是主题不同导致的差异
      • 8578a911ec40:楼主还想问个问题,这个toolbar是21的api,,如果在低版本中回兼容到几点几,?你是通过什么方式知道它是兼容到多少的?是查阅资料,还是在很多版本中去实际得到的结果。还望楼下解答,,谢谢
        DoAndKeep:@8578a911ec40 我们的依赖是com.android.support:appcompat-v7:24.1.1,这个是v7包,也就是支持到api7,即2.1了。
      • 8578a911ec40:自定义的view是通过属性来控制显示的位置,还是默认就是在中间?
        608924568ff8:@DoAndKeep 返回按钮不能微调他的显示位置吗
        DoAndKeep:@8578a911ec40 出去最左面的icon以及最右边的action,中间的部分就是自定义view的位置。如果你设置不显示home icon以及没有action,那么自定义view就是整体的大小了。
      • fendo:下载你的项目导入AS,并不能运行,点击DEMO,微博,两个按钮没反应.....
        DoAndKeep:@fendo 这个需要使用自己继承微博SDK的相关密钥key值。
      • fendo:赞一个!
      • Cyandev:支持

      本文标题:Toolbar使用详解

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