XRecyclerViewDivider是一个功能十分强大且全面的RecyclerView 分割线库，使用建造者模式初始化Decoration,链式调用即可绘制你所需要的分割线样式，间接减少重复性代码，主要有三个建造者： XLinearBuilder、XGridBuilder、XStaggeredGridBuilder 它们分别为LinearLayoutManager、GridLayoutManager、StaggeredGridLayoutManager绘制不一样的分割线。
在你的 Project build.gradle文件中添加：
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}在你的 Module build.gradle文件中添加：
dependencies {
implementation 'com.github.huangxiaolianghh:XRecyclerViewDivider:1.0.2'
} |
 |
 |
 |
 |
 |
 |
 |
- 支持水平竖直方向LayoutManager
- 支持设置第一个item 上边距
- 支持设置最后一个item的分割线
- 支持space大小、分割线padding、分割线是否绘制到RecyclerView的padding
- 支持设置分割线color、drawable
- 支持设置不显示哪些item分割线
- 支持定制某个item的分割线（包括padding、color、drawable、设置边界等）
XLinearBuilder属性表格
| 属性 | 意义 |
|---|---|
| mSpacing | 分割线间距，默认1dp;可直接设置dp或dp对应的res |
| mShowLastLine | 是否绘制最后一个item的分割线，默认false |
| mShowFirstTopLine | 是否绘制第一个item上边或左边分割线，默认false |
| mIsIncludeParentLTPadding | 分割线是否绘制RecyclerView的左或上padding部分，默认false |
| mIsIncludeParentRBPadding | 分割线是否绘制RecyclerView的右或下padding部分，默认false |
| mLeftPadding | mTopPadding | 分割线左边距或上边距 |
| mRightPadding | mBottomPadding | 分割线右边距或下边距 |
| mColor | 分割线的颜色 |
| mDividerDrawable | 分割线的drawable |
| mOnNoDividerPosition | position分割线不绘制的回调，返回position的数组，为null不处理 |
| mOnItemDivider | 定制某条分割线的回调，返回的是LDecoration，为null不处理 |
LDecoration主要是设置某条分割线的属性，如果设置了setPadding方法，则会把mLeftPadding、mTopPadding、mRightPadding、mBottomPadding设置，设置了mDividerDrawable会覆盖mColor，具体可看源码。
基本使用：
new XLinearBuilder(this)
//分割线间距，支持float dp 和DimenRes dp
.setSpacing(4f)
.setShowFirstTopLine(true)
.setShowLastLine(true)
.setColor(Color.BLACK)
//设置哪几个position不绘制分割线，接受数组new int[]{0,1}，返回null表示不处理
.setOnItemNoDivider(() -> null)
//定制某一item分割线样式，可改颜色和设置边沿分割线，返回null表示不处理
.setOnItemDividerDecoration(new XLinearBuilder.OnItemDivider() {
@Override
public LDecoration getItemDividerDecoration(int position) {
if (position == 1) {
return new LDecoration(LinearActivity.this)
.setColor(Color.RED);
}
return null;
}
})
;如果想全部绘制边沿分割线，可这样设置：
new XLinearBuilder(this)
//分割线间距，支持float dp 和DimenRes dp
.setSpacing(4f)
.setShowFirstTopLine(true)
.setShowLastLine(true)
.setColor(Color.BLACK)
//设置哪几个position不绘制分割线，接受数组new int[]{0,1}，返回null表示不处理
.setOnItemNoDivider(() -> null)
//定制某一item分割线样式，可改颜色和设置边沿分割线，返回null表示不处理
.setOnItemDividerDecoration(new XLinearBuilder.OnItemDivider() {
@Override
public LDecoration getItemDividerDecoration(int position) {
return new LDecoration(LinearActivity.this)
.setAroundEdge(true, null, true, null)
.setColor(Color.RED);
}
});具体还有很多功能，可clone下来，自己去体验。
- 支持水平竖直方向GridLayoutManager
- 支持设置是否显示边界
- 可分别设置水平方向和竖直方向的space、color、drawable等
- 支持SpanSizeLookup（不规则的Grid）
- 支持设置横竖交叉处的归属（属于竖向或横向）
XGridBuilder属性表格
| 属性 | 意义 |
|---|---|
| mSpacing | 分割线间距，默认0dp;可直接设置dp或dp对应的res |
| mVLineSpacing | 竖直线的间距，默认0dp，会覆盖mSpacing |
| mHLineSpacing | 水平线的间距，默认0dp，会覆盖mSpacing |
| mIsIncludeEdge | 是否绘制边界，默认false |
| mVerticalIncludeEdge | 分割线交叉处是否属于竖直线的部分，默认false |
| mVLineColor | 竖直分割线颜色 |
| mHLineColor | 水平分割线颜色 |
| mColor | 分割线的颜色，会被mVLineColor或mHLineColor覆盖 |
| mVLineDividerDrawable | 竖直分割线的drawable |
| mHLineDividerDrawable | 水平分割线的drawable |
| mDividerDrawable | 分割线的drawable,会被mVLineDividerDrawable或mHLineDividerDrawable覆盖 |
基本使用：
new XGridBuilder(this)
//分割线间距，支持float dp 和DimenRes dp
.setSpacing(2f)//这几个Spacing的优先级可看XGridBuilder说明
.setVLineSpacing(4f)
.setHLineSpacing(8f)
//这几个color和drawable的优先级可看XGridBuilder说明
.setColor(Color.BLUE)
//可设置颜色和drawable,drawable>color
// .setColorRes(R.color.white)
// .setDrawable(new ColorDrawable(Color.WHITE))
// .setDrawableRes(R.drawable.)
.setHLineColor(Color.BLACK)
// .setHLineDrawable()
.setVLineColor(Color.RED)
// .setVLineDrawable()
//是否包括边界
.setIncludeEdge(true)
//竖直和水平分割线交叉处绘制的是竖直分割线颜色（交叉处属于竖直分割线）
.setVerticalIncludeEdge(true)
;- 支持水平竖直方向StaggeredGridLayoutManager
- 支持设置是否显示边界
- 可设置水平方向和竖直方向的space、不支持color、drawable（基本不用）
- 支持设置FullSpan情况
XStaggeredGridBuilder属性表格
| 属性 | 意义 |
|---|---|
| mSpacing | 分割线间距，默认0dp;可直接设置dp或dp对应的res |
| mVLineSpacing | 竖直线的间距，默认0dp，会覆盖mSpacing |
| mHLineSpacing | 水平线的间距，默认0dp，会覆盖mSpacing |
| mIsIncludeEdge | 是否绘制边界，默认false |
| mIsIgnoreFullSpan | 边界绘制是否忽略FullSpan的情况，默认false |
基本使用：
new XStaggeredGridBuilder(this)
//分割线间距，支持float dp 和DimenRes dp
.setSpacing(2f)//这几个Spacing的优先级可看XGridBuilder说明
.setVLineSpacing(4f)
.setHLineSpacing(8f)
//是否包括边界
.setIncludeEdge(true)
//是否忽略FullSpan的情况
.setIgnoreFullSpan(true)
;感谢：ByRecyclerView，采纳了其对FullSpan处理的一些思想。
使用中有问题或没有实现的功能都可以反馈给我，我一定会尽量满足大家的需求。希望这个库能够帮到大家，欢迎star~。