RecyclerView.ItemDecoration不仅仅只是用来画线实现分割线这么简单;
你可以绘制everything, 只要你想要; 都可以;
最常用的:
绘制分割线;
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方法绘制之后执行;
这个方法通常用来绘制需要悬停的分割线, 比如 分组的组名,等;
支持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;
}