Android-->RecyclerView.ItemDecoration分割线详解

RecyclerView.ItemDecoration不仅仅只是用来画线实现分割线这么简单;

你可以绘制everything, 只要你想要; 都可以;

最常用的:
绘制分割线;
绘制分组标题;点这里查看效果图

参考文档:
http://blog.csdn.net/pengkv/article/details/50538121

---

ItemDecoration有3个重要的方法:

@Override
public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
   super.onDraw(c, parent, state);
}

@Override
public void onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state) {
   super.onDrawOver(c, parent, state);
}

@Override
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
   super.getItemOffsets(outRect, view, parent, state);
}

但其实:

//onDrawOver方法实现的效果和onDraw是一样的,这样的话,就只剩下2个方法了;
@Override
public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
   super.onDraw(c, parent, state);
}

@Override
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
   super.getItemOffsets(outRect, view, parent, state);
}

为了更好的查看效果,你只要实现这一个方法就够了:

@Override
public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
   super.onDraw(c, parent, state);
   //你只需要使用自定义View的套路, 这里绘制效果就行;
}

---

getItemOffsets方法说明

getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state)

这个方法的作用很简单, 也很好理解
就是用来设置view的腾出空间

第一个参数: outRect 用来返回数据
outRect.set(l, t, r, b);
表示view的左边腾出l距离, view的上边腾出t距离, view的右边腾出r距离, view的下边腾出b距离.
你可以只设置其中一个, 也可以设置全部的4个, 也可以一个都不设置; 这个取决于你.
这里腾出的距离, 会在onDraw方法中体现出来; 如果腾出的距离不够, 那么分割线就会覆盖Item绘制.

有了距离之后, 就是可以在onDraw中绘制分割线了;

---

onDraw方法说明

onDraw(Canvas c, RecyclerView parent, RecyclerView.State state)

这个方法有一点需要说明, 你需要绘制所有可见view的分割线, 而不是只绘制一个view的分割线;
所以你至少需要遍历当前RecyclerView中,所有可见的view

//你可能就需要像我一样, 遍历一遍了;
final LinearLayoutManager layoutManager = (LinearLayoutManager) manager;
final int firstItem = layoutManager.findFirstVisibleItemPosition();
for (int i = 0; i < layoutManager.getChildCount(); i++) {
    final View view = layoutManager.findViewByPosition(firstItem + i);
    if (view != null) {
        if (layoutManager.getOrientation() == LinearLayoutManager.HORIZONTAL) {
            //水平
            drawDrawableV(c, view);
        } else {
            //垂直
            drawDrawableH(c, view);
        }
    }
}

---

onDrawOver方法说明

onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state)

此方法, 和onDraw效果是一样的, 唯一的不同就是, onDrawOver方法会在onDraw方法绘制之后执行;
这个方法通常用来绘制需要悬停的分割线, 比如 分组的组名,等;

---

这里有一份我写的分割线源码:GitHub传送门

支持GridLayoutManager和LinearLayoutManager,暂不支持StaggeredGridLayoutManager,
没时间写.而且本人用的也不多, 所以…如果有需要,可以联系我, 我再添加.

使用方法:

recyclerView.addItemDecoration(new RBaseItemDecoration());//不带参数的构造方法, 全部采用默认值

public RBaseItemDecoration() {
    this(1);
}
//创建一个指定高度的分割线
public RBaseItemDecoration(int dividerSize) {
    this(dividerSize, dividerColor);
}
//创建一个自定义的分割线
public RBaseItemDecoration(Drawable drawable) {
    this(drawable, 1);
}
//创建自定义大小和颜色的分割线
public RBaseItemDecoration(int dividerSize, int dividerColor) {
    mDividerSize = dividerSize;
    mDividerDrawableV = new ColorDrawable(dividerColor);
    mDividerDrawableH = mDividerDrawableV;
}
//创建一个自定义的分割线,并指定大小
public RBaseItemDecoration(Drawable drawable, int dividerSize) {
    mDividerSize = dividerSize;
    mDividerDrawableV = drawable;
    mDividerDrawableH = drawable;
}

更高级的用法:

//GridLayoutManager可以分别设置垂直方向的Drawable和水平方向的Drawable
//设置垂直方向的Drawable
public void setDividerDrawableV(Drawable dividerDrawableV) {
    mDividerDrawableV = dividerDrawableV;
}
//设置水平方向的Drawable
public void setDividerDrawableH(Drawable dividerDrawableH) {
    mDividerDrawableH = dividerDrawableH;
}
//设置分割线的Margin,影响开始的位置
public void setMarginStart(int marginStart) {
    mMarginStart = marginStart;
}
//设置分割线的Margin,影响结束的位置
public void setMarginEnd(int marginEnd) {
    mMarginEnd = marginEnd;
}

---

至此: 文章就结束了,如有疑问: QQ群 Android:274306954 Swift:399799363 欢迎您的加入.