ToolBar项目封装之踩坑过河

不知不觉又到周五啦，提前祝大家周末愉快！

本篇来自 Stone_ZH 的投稿，记录了他在使用ToolBar时遇到的一些“坑”，希望他的经验总结能给大家带来帮助。

Stone_ZH 的博客地址：http://blog.csdn.net/zzz_zzz_z

简介

继承关系：

java.lang.Object
   ↳    android.view.View
       ↳    android.view.ViewGroup
           ↳    android.widget.Toolbar

其实 Toolbar 就是一个封装好的 ViewGroup。

其主要五大部分对应的子View如下：

//菜单，ActionMenuView也是个ViewGroup
private ActionMenuView mMenuView;
//主标题
private TextView mTitleTextView;
//副标题
private TextView mSubtitleTextView;
//导航按钮
private ImageButton mNavButtonView;
//Logo图标
private ImageView mLogoView;

看下图，比较清晰：

项目封装

一. 配置 theme，为了适配5.0之后安卓的设计，做起 statusbar 的颜色适配：

这里注意下，主题使用的 parent是 Theme.AppCompat.Light.Theme.AppCompat.Light.NoActionBar，当然有些项目中配全局Theme时候还是用的 Theme.AppCompat.Light.DarkActionBar，这时候需要改成没有ActionBar的主题，这里可以直接改成 Theme.AppCompat.Light.Theme.AppCompat.Light.NoActionBar，但是有些项目里如果想有些地方使用 Actionbar 有些地方使用 Toolbar（当然很少。。）可以这样配一下即可：

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

这里有个坑 —— Android设置theme中的坑：

报错如下：

This Activity already has an action bar supplied by the window decor. Do not request Window.FEATURE_SUPPORT_ACTION_BAR

原因一：

错误的写法：

其中 AppTheme 使用的主题是 AppCompat的主题，由于 AppCompat主题下的 windowActionBar和windowNoTitle 的命名方式前都没有android字样，所以报错。

正确写法：

原因二：

如果主题设置成有 Actionbar的Theme 并且没有配：

<item name="windowActionBar">false</item>
<item name="windowNoTitle">true</item>

也会出这样的错误，看下源码：

在我们设置toolbar时候：

((AppCompatActivity)getActivity()).setSupportActionBar(toolbar);

可以看到源码调用逻辑是：

public void setSupportActionBar(@Nullable Toolbar toolbar) {
    getDelegate().setSupportActionBar(toolbar);
}

在往下追一步，出真相了：

然后在需要使用 Toolbar的activity 里给他配上这样的 theme 即可：

<activity
    android:name=".ui.activity.MainTabBarActivity"
    android:label="@string/app_name"
    android:screenOrientation="portrait"
    android:launchMode="singleTask"
    android:theme="@style/AppTheme.NoActionBar"
    android:windowSoftInputMode="stateHidden">
</activity>

关于 theme 中几个 color字段 的描述看谷歌官方图，如下：

或者看谷歌文档（自备梯子）：

Material Theme

https://developer.android.com/training/material/theme.html

由于我们项目里设定了 toolbar 的高度，这里指定了 actionBarSize，然后通过设置 toolbar 高度为这个值。

二. 由于项目中 toolbar 归属于 fragment 管理，所以这里是将 toolbar 封装在 fragment 中处理了，这里通过各个 fragment的xml 添加<include layout="@layout/toolbar_layout"/>：

toolbar_layout.xml 如下：

toolbar上的东西被我分成五种：

• navigationicon：通过setNavigationIcon去处理。

  
  

• logo：通过setlogo。

  
  

• title与subtitle：通过setTitle与setSubtitle去处理。

  
  

• 自定义部分：这里也分成左中右三个部分，可以看上面布局文件，通过标签android:layout_gravity 来指定位置，这里有坑，自定义部分布局最左边有间隙，如果要去掉，可以设置：contentInset 这个标签去除。

  
  

• menu：menu的显示方式可以自行设置。

这样来看，基本所有的需求都能满足了；

三. fragment 中抽象封装：

这里要看各个项目需求，由于我们公司项目中对最右边图标灵活度要求并不高，我一般使用menu就可以解决了，如果menu不能满足你，完全可以使用自定义部分中的“右部分”。

下面进入封装，在baseFragment中做了如下封装，项目中使用的是JakeWharton的注入框架：

butterknife链接

https://github.com/JakeWharton/butterknife

①. 首先注入 toolbar 及自定义部分中除最右边图标的控件，因为最右边图标我们项目中一般 menu 就够用了：

@BindView(R.id.toolbar)
protected Toolbar mToolBar;
@BindView(R.id.center_title)
TextView mCenterTitle;
@BindView(R.id.nav_left_text)
TextView mNavLeftText;

②. 然后在初始化 fragment 视图时候将 mToolBar、mCenterTitle、mNavLeftText 传给其 子fragment 进行定制，这三个控件传递出去后完全可以定制 navigationicon、logo、title与subtitle, 自定义部分这四个部分：

以下代码中的 initview和popFragment 是我封装好的在 fragment的OncreateView 时候调用的，详细封装请看：

浅谈Activity,Fragment模块化封装

http://blog.csdn.net/zzz_zzz_z/article/details/51521041

@Override
protected void initView(View view, Bundle savedInstanceState) {
    initToolBar(mToolBar, mCenterTitle, mNavLeftText);
}

这里有个坑：

((AppCompatActivity)getActivity()).getSupportActionBar().setDisplayShowTitleEnabled(false);

必须设置这个，不然默认的title一直在，即使你设置了 toolbar.settitle(“xxoo”) 。。。

这里做了一件事，给 navigationButton 导航按钮做了个监听，pop出当前这个 fragment 出栈。

③. 还剩最后一个东西没有定制：menu

这个很简单，不过也要注意下，必须在fragment中设置菜单，一定要先设置：

setHasOptionsMenu(true);

关于源码，可以去看下，然后处理方式很简单了：

@Override
public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) {
    inflater.inflate(R.menu.search, menu);
    super.onCreateOptionsMenu(menu, inflater);
}

这里也有个坑——如果你没有设置：

((AppCompatActivity)getActivity()).setSupportActionBar(toolbar);

那么 onCreateOptionsMenu 并不会被回调。

最后做下menu的监听即可：

总结

Toolbar 是 Android5.0 之后出现的MD设计风的控件，支持5.0之后的 elevation 特性，相比较 Actionbar 具有高度自定义的特性，因为其本身是一个 ViewGroup 内部布局完全自由处理，这样大大扩展了其自由定制性，不多说，赶紧开始替换Actionbar吧！

---

如果你有好的技术文章想和大家分享，欢迎向我的公众号投稿，投稿具体细节请在公众号主页点击“投稿”菜单查看。

欢迎长按下图 -> 识别图中二维码或者扫一扫关注我的公众号：