前言
今年换了新工作 ， 刚开始熟悉项目 ，今天终于交付了一个版本 ， 整个人忙得晕头转向 ， 每次接手新项目 ，都需要一段时间去熟悉项目 ， 有时候会因为不熟悉前任写的代码 ， 可能会掉进不明不白的坑里 ， 至此，我觉得想要最快熟悉前任写代码 ，当前又没有任务 ，可以小范围重构 ， 并进行测试 ， 可以减少因为不熟悉项目的一些细节 ，而踩到不明不白的坑 。
ItemDecoration
使用过RecyclerView的朋友肯定有过这样的经历 ， 以前在使用ListView的时候，在Item之间的分割线上 ， 使用ListView的divider属性就可以搞定，但在RecyclerView中却再也没见到这个属性，那么他到哪里去了呢 ？ RecyclerView给我们提供了这样的方法addItemDecoration(ItemDecoration decor) 传递进去的ItemDecoration对象就是今天的主角，专门用于处理Item之间的间隔和拓展 。
从RecyclerView源码中可以看到，ItemDecoration是其子类并且还是一个抽象类，里面有几个抽象方法，需要我们继承ItemDecoration，并进行重写的 。
/**
* 获得条目偏移量 ， 回调此方法来确定每个Item的偏移量
* @param outRect 矩形区域 , 每一个Item都是一个矩形区域，rect表示矩形区域的四个方位
* @param view 每个条目的View对象
* @param parent
* @param state
*/
@Override
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
}
/**
* 间隔线绘制
* @param c
* @param parent
* @param state
*/
@Override
public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
}
我们从源码中可以看到 ， ItemDecoration里面，全是RecyclerView在内部会回调的方法，并提供onDraw方法 ，这样给了我们极大的自定义性，可以画出任意图案的Item 。
自定义简单的ItemDecoration
移动设备开发，大部分时间都是在可以List列表类打交道，因为手持设备的显示空间有限，可以只能通过上下滑动来展示更多的内容。因为RecyclerView没有给我们提供常规的divider，那么我们就指定一个简单的ItemDecoration，了解它自定义的原理 。只有了解了其原理 ， 以后想要什么样的都有 。
ItemDecoration给我们提供了两个方法，onDraw方法自不必多说 ， 大家都知道 。getItemOffsets这个方法估计就比较少见了， 这个方法是设置我们每个Item的偏移量，也就是我们需要Item给出多大的绘制空间 ， 这个方法给了Rect对象，用来设置巨型的偏移量，也就是每个Item多出多烧来进行绘制你给的图案 。
getItemOffsets 图解
rect 偏移量图解
由图上可以看出 ， 每个Item都是一个rect ， 而我们要绘制的就是rect的四个边， 上图是以画类似ListView的divider为例子 。
画水平线
画水平线 ， 想要画水平线，就要先弄清楚 ， 要画rect的哪个边，就List的来说，是rect的下边也就是bottom 。在getItemOffsets设置rect的下边的偏移量 。
设置偏移量
outRect.set(0,0,0,drawable.getIntrinsicHeight()); // 将drawable绘制在Item的底部
这样就在rect的底部 ， 偏移了一定的高度，可以绘制并显示我们的图案 。
绘制
/**
* 画水平线
* @param c 画布
* @param parent
*/
private void drawHorizontalLine(Canvas c, RecyclerView parent) {
int left = parent.getPaddingLeft(); // 从recyclerView容器内边距算起 ， 左边起点坐标
int right = parent.getWidth() - parent.getPaddingRight(); // recyclerView宽度减去paddingRight计算右边坐标
// 以上 , Item decoration的宽度坐标确定 ， 即rect的宽度
int childCount = parent.getChildCount();
for (int i = 0; i <childCount ; i++) {
View childView = parent.getChildAt(i);
RecyclerView.LayoutParams layoutParams = (RecyclerView.LayoutParams) childView.getLayoutParams();
int top = childView.getBottom() + layoutParams.bottomMargin + Math.round(ViewCompat.getTranslationY(childView));
int bottom = top + drawable.getIntrinsicHeight();
// 每一个Item都需要绘制一遍
drawable.setBounds(left,top,right,bottom);
drawable.draw(c);
}
}
因为绘制的是Drawable所以也需要指定drawable的rect ， 指定rect的方法为drawable.setBounds(left,top,right,bottom);，这样来确定drawable绘制的图形大小宽高 。
画水平线，所有rect的左边是从RecyclerView的左内边距算起(内边距不参与绘制) ， 右边就是RecyclerView的整个宽度减去右内边距，这样计算得出Item的宽度 。因为是ListView，每条线都在不同的Item下，所有rect的上边就在每个Item的bottom下面，所有drawable的上边就要从每个Item的下边算起，即 childView.getBottom() + layoutParams.bottomMargin + Math.round(ViewCompat.getTranslationY(childView)); 而drawable rect的下边则是每个Item的bottom 加上 drawable的高度 ， 这样drawable rect的四个边就计算完成了 ， 我们水平线也就画出来了 。
完整源码
public class SimpleItemDecoration extends RecyclerView.ItemDecoration {
private int orientation;
private Drawable drawable;
public SimpleItemDecoration(@NonNull int orientation, @NonNull Drawable drawable) {
this.orientation = orientation;
this.drawable = drawable;
}
/**
* 设置RecyclerView的布局管理器
* @param orientation
*/
public void setOrientation(int orientation) {
if (LinearLayoutManager.HORIZONTAL != orientation && LinearLayoutManager.VERTICAL != orientation)
new IllegalArgumentException("RecyclerView不支持此布局管理器");
this.orientation = orientation;
}
/**
* 获得条目偏移量 ， 回调此方法来确定每个Item的偏移量
* @param outRect 矩形区域 , 每一个Item都是一个矩形区域，rect表示矩形区域的四个方位
* @param view 每个条目的View对象
* @param parent
* @param state
*/
@Override
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
if (LinearLayoutManager.VERTICAL == orientation) {
outRect.set(0,0,0,drawable.getIntrinsicHeight()); // 将drawable绘制在Item的底部
}else if (LinearLayoutManager.HORIZONTAL == orientation) {
outRect.set(0,0,drawable.getIntrinsicWidth(),0); // 将drawable绘制在Item的右边
}
}
/**
* 间隔线绘制
* @param c
* @param parent
* @param state
*/
@Override
public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
if (LinearLayoutManager.VERTICAL == orientation) {
drawHorizontalLine(c,parent); //画水平线
}else if (LinearLayoutManager.HORIZONTAL == orientation) {
drawVerticalLine(c,parent); // 画垂直线
}
}
/**
* 画水平线
* @param c 画布
* @param parent
*/
private void drawHorizontalLine(Canvas c, RecyclerView parent) {
int left = parent.getPaddingLeft(); // 从recyclerView容器内边距算起 ， 左边起点坐标
int right = parent.getWidth() - parent.getPaddingRight(); // recyclerView宽度减去paddingRight计算右边坐标
// 以上 , Item decoration的宽度坐标确定 ， 即rect的长度
int childCount = parent.getChildCount();
for (int i = 0; i <childCount ; i++) {
View childView = parent.getChildAt(i);
RecyclerView.LayoutParams layoutParams = (RecyclerView.LayoutParams) childView.getLayoutParams();
int top = childView.getBottom() + layoutParams.bottomMargin + Math.round(ViewCompat.getTranslationY(childView));
int bottom = top + drawable.getIntrinsicHeight();
// 每一个Item都需要绘制一遍
drawable.setBounds(left,top,right,bottom);
drawable.draw(c);
}
}
/**
* 画垂直线
* @param canvas
* @param parent
*/
private void drawVerticalLine(Canvas canvas,RecyclerView parent) {
int top = parent.getPaddingTop();
int bottom = parent.getHeight() - parent.getPaddingBottom();
int childCount = parent.getChildCount();
for (int i = 0; i <childCount ; i++) {
View childView = parent.getChildAt(i);
RecyclerView.LayoutParams layoutParams = (RecyclerView.LayoutParams) childView.getLayoutParams();
int left = childView.getRight() + layoutParams.rightMargin + Math.round(ViewCompat.getTranslationX(childView));
int right = left + drawable.getIntrinsicWidth();
drawable.setBounds(left,top,right,bottom);
drawable.draw(canvas);
}
}
}
结语
RecyclerView很强大 ， 但是需要自定义的很多 ， 这也就造成了RecyclerView可以写出千变万化的UI出来，如此松耦合的库，需要我们不断的去学习 。
很久没写文章了 ， 今年忙碌并且充实着，也即将迎来人生中的第一辆车，想想浑身都是动力 。
网友评论