高拓展高自定义性ActionBar，完美替代Android系统默认.zip

# [求职](https://github.com/goweii/job-wanted) # ActionBarEx **高拓展高自定义性ActionBar，完美替代Android系统默认。** - 支持自定义标题栏布局，支持XML中直接以子布局编写 - 支持自定义前景布局，如显示Loading效果 - 支持自定义背景布局，如图片等 - 支持自定义底部分割线，可以投影效果显示在外部 - 支持自适应状态栏暗亮色图标模式，可实时动态刷新 - 状态栏暗亮色图标模式已适配常见国产ROM，详见[StatusBarCompat](https://github.com/goweii/StatusBarCompat) - 已封装3种通用样式，可按需引入 [GitHub主页](https://github.com/goweii/ActionBarEx) [Demo下载](https://github.com/goweii/ActionBarEx/raw/master/app/release/app-release.apk) ## 项目简介 ## 为什么要写一个ActionBar？官方的和网上开源的那么多。 第一，先说说官方的。官方的在不同系统上的风格并不统一，自定义项太少，不能满足开发需求，所以才涌现了这么多的开源项目。 第二，网上开源的。网上的已有的，我发现的，用过的大部分都是直接封装一个固定样式的布局，或控制控件的显示隐藏，或动态添加需要的控件。但也仅限于自定义左右图标的和中间标题的个数和样式。如果要自定义ActionBar的背景呢？要让背景显示一个图片呢？要让图片延伸到状态栏下面呢？要让背景实现半透明高斯模糊效果呢？要限定按钮图标的大小呢？要自定义中间标题的背景呢？要显示一个搜索框呢？要让搜索框带有清空和搜索图标呢？要自定义搜索框样式呢？要在网络请求时显示一个Loading效果呢？等等这些需求都是无法满足的。而且我相信这样的需求不在少数。 **也可能有可以实现的框架，只是我还没发现。** ## GitHub上Star那么多的框架都无法实现，这个就可以？ 要说这个绝对可以实现，肯定是不可能的，但我相信可以实现市面上99%以上的需求。 **哪里来的这么大的自信？还是先看看整个项目的层级结构吧。** 整个ActionBarEx分为3个基本层级，具体负责功能和命名约定如下： | 根层级 | 子层级 | 说明 | 备注 | | ------------------- | ---------- | ------ | :----------- | | **BackgroundLayer** | | 背景层 | 可自定义布局 | | **ActionBarLayer** | | 主体层 | 垂直线性布局 | | | StatusBar | 状态栏 | | | | TitleBar | 标题栏 | 可自定义布局 | | | BottomLine | 分割线 | | | **ForegroundLayer** | | 前景层 | 可自定义布局 | - **BackgroundLayer** 背景层，负责整个ActionBar背景的绘制，如实现半透明背景或图片背景或高斯模糊背景 - **ActionBarLayer** 主体层，是以下3个不分的统称： - StatusBar 系统状态栏占位，可控制单独显示一个背景色，可实现状态栏图片暗色和亮色模式切换 - TitleBar 导航栏占位，用于显示标题图标按钮等，支持自定义布局样式，以实现复杂需求 - BottomLine 底部分割线，可控制分割线颜色和高度 - **ForegroundLayer** 前景层，用于显示一些特殊的状态，如加载状态LoadingBar，支持自定义布局 ## 别整这么多虚的，先看看疗效     ## 呦吼，看着还不错呀，快告诉我怎么用？ 别急呀，我再说说实现细节。 好好，别动手，有话好好说，你把这个规则长方体放下。。。 要说使用方式，还得再明确几个类 - ActionBarEx 这个就是上面说的封装好的分3个层级的基类 - ActionBarCommon 继承自ActionBarEx，标题栏布局为【图标-文字-标题文字-文字-图标】 - ActionBarSearch 继承自ActionBarEx，标题栏布局为【图标-文字-搜索框-文字-图标】 - ActionBarSuper 继承自ActionBarEx - 支持自定义主标题和副标题显示 - 支持自定义标题位置居中或居左 - 左右分别支持最多5个按钮 - 支持精确自定义每个按钮的边距 # 集成方式 ## 添加依赖 1. 在Project的**build.gradle**添加仓库地址 ``` allprojects { repositories { ... maven { url 'https://www.jitpack.io' } } } ``` 2. 在Model:app的**build.gradle**添加框架依赖 最新版本是多少，看下[Releases](https://github.com/goweii/ActionBarEx/releases) 从2.2.9以后版本去除版本号前的v，引用时需要注意下。 从3.0.0版本开始分离了ActionBarEx和ActionBarCommon/Search。 从3.1.0版本新增ActionBarSuper ```groovy dependencies { // 完全引入 implementation 'com.github.goweii:ActionBarEx:3.2.2' // 只引入ActionBarEx implementation 'com.github.goweii.ActionBarEx:actionbarex:3.2.2' // 引入ActionBarCommon/Search/Super，依赖于ActionBarEx implementation 'com.github.goweii.ActionBarEx:actionbarex-common:3.2.2' } ``` ## 简单需求只需要下面2步就可以了 这里用ActionBarCommon举个例子 1. 布局文件引用 ```xml <per.goweii.actionbarex.common.ActionBarCommon android:id="@+id/simple_action_bar_3" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_marginTop="10dp" android:background="#ccffffff" app:ab_autoImmersion="false" app:ab_bottomLineColor="@color/line" app:ab_bottomLineHeight="0dp" app:ab_foregroundLayerLayout="@layout/loading_bar" app:ab_statusBarColor="@color/transparent" app:ab_statusBarMode="dark" app:ab_statusBarVisible="false" app:ab_titleBarHeight="48dp" app:abc_leftIconColor="@color/black" app:abc_leftIconRes="@mipmap/back" app:abc_leftText="返回" app:abc_leftTextPaddingLeft="0dp" app:abc_leftTextPaddingRight="0dp" app:abc_rightIconColor="@color/black" app:abc_rightIconRes="@mipmap/search" app:abc_rightText="确定" app:abc_rightTextPaddingLeft="0dp" app:abc_rightTextPaddingRight="0dp" app:abc_titleText="这个标题有点长我试试长标题什么样子" app:abc_titleTextMaxWidth="180dp" /> ``` 2. 代码中绑定事件 ```java actionBarCommon.setOnLeftIconClickListener(new OnActionBarChildClickListener() { @Override public void onClick() { Toast.makeText(context, "onLeftIconClick", Toast.LENGTH_SHORT).show() } }); ``` ## 复杂一点的需求，需要自定义导航栏布局 使用起来是这个样子的 1. 自定义布局文件 title_bar_custom.xml ```xml <?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="48dp"> <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="horizontal"> <ImageView android:id="@+id/iv_back" android:layout_width="48dp" android:layout_height="48dp" android:padding="15dp" android:scaleType="fitCenter" android:src="@mipmap/back" /> <TextView android:layout_width="wrap_content" android:layout_height="match_parent" android:gravity="center" android:text="自定义布局" android:textColor="@color/white" android:textSize="17sp" /> </LinearLayout> <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:gravity="right" android: