整理一下，每次用的时候还得回忆，以后就复制了。
主要就是用来处理item之间的间隔

使用的时候rv.addItemDecoration即可

需要注意的是，这方法是add，不是set。也就是它是放到一个集合里的，你多次调用这个add方法，那么就添加了N个，到时候你会发现间距不停的变大。这种情况很多时候出现在刷新数据以后，又调用了这个方法。需要注意。

简单分析下这个类的几个方法

image.png

主要就3个方法

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

设置间隔的大小的，修改ourRect这个参数即可，里边有left，right，top，bottom属性
举例,如下，第一个item，有个top 30，那么你看到的效果就是第一个item距离上边有30个间隔，就是这里设置的。

 val i=parent.getChildAdapterPosition(view)
    if(i==0)
            outRect.top=30

public void onDraw(Canvas c, RecyclerView parent, State state)

这里就是来操作上边弄的间隔的，默认间隔就是个空白，这里你可以随便画点啥。

public void onDrawOver(Canvas c, RecyclerView parent, State state)

这个看名字，就是画在最顶层的，你也可以理解成最后画

上边就简单分析下，太久了，都不记得具体的谁在谁上边了。有空再看下再修改。

联系人首字母索引

今天主要弄下下边这种效果

image.png

上代码，也不算太难

import android.graphics.*
import android.support.v7.widget.LinearLayoutManager
import android.support.v7.widget.RecyclerView
import android.view.View
import java.util.ArrayList

/**
 * Created by charlie.song on 2018/4/3.
 * 此类只支持垂直方向的layoutmanager，不做验证，非此LayoutManager会挂掉。
 */
 abstract class ItemDecorationContact<T>:RecyclerView.ItemDecoration(){

    var datas= ArrayList<T>()
    abstract fun getDrawText(t:T):CharSequence//要画什么东西
    abstract fun indexEqual(pre:T,t:T):Boolean//返回两者的索引是否一样

    override fun getItemOffsets(outRect: Rect, view: View, parent: RecyclerView, state: RecyclerView.State) {
        super.getItemOffsets(outRect, view, parent, state)
            val i=parent.getChildAdapterPosition(view)
            outRect.top=if(needDraw(i)) indexHeight else 0
    }
    var indexHeight=60;//要画的分组索引的高度
    var paintFloatBg=Paint()//背景
    val paintFloatBgText=Paint()//文字
    var floatingTextLeft=20f;//要画的文字距离左边的间距
    var textHeight=0;//测量的索引字母的高度
    var floatRect=Rect()//用来画索引的布局方位
    open fun initSomeThing(){
        paintFloatBgText.textSize=30f
        val bounds=Rect()
        paintFloatBgText.getTextBounds("G",0,1,bounds)
        textHeight=bounds.height();
        paintFloatBgText.color=Color.RED
        paintFloatBg.color=Color.parseColor("#888888")
    }
    override fun onDraw(c: Canvas, parent: RecyclerView, state: RecyclerView.State) {
        super.onDraw(c, parent, state)
        if(datas.size==0){return}
        if(textHeight==0){
            initSomeThing()
        }
        for(i in 0 until parent.childCount){
            val child=parent.getChildAt(i);
            if(child!=null){
                val position=parent.getChildAdapterPosition(child)
                if(needDraw(position) ){
                    val rect=Rect(child.left, (child.top-indexHeight), child.right, child.top)
                    drawFloatingBg(c, rect,paintFloatBg)
                    drawFloatingBgText(c,getDrawText(datas.get(position)),child.left+floatingTextLeft,child.top-(indexHeight-textHeight)/2f,paintFloatBgText,rect)
                }
            }
        }
    }

    //画分组背景颜色
    open fun drawFloatingBg(c:Canvas,rect: Rect,paint: Paint){
        c.drawRect(rect,paint)
    }
    //话分组条上的文字,rect是分组背景的范围
    open fun drawFloatingBgText(c:Canvas,text:CharSequence,x:Float,y:Float,paint: Paint,rect: Rect){
        c.drawText(text,0,1,x,y,paintFloatBgText)
    }
    //第一条or和自己上一条的首字母不一样，那么肯定是个新的首字母，就画出来
    private fun needDraw(position:Int):Boolean{
        if(datas.size==0){
            return false
        }
        if(position==0){
            return true
        }
        return !indexEqual(datas.get(position-1),datas.get(position))
    }
    override fun onDrawOver(c: Canvas, parent: RecyclerView, state: RecyclerView.State) {
        super.onDrawOver(c, parent, state)
        if(datas.size==0){return}
        floatRect.set(0,0,parent.width,indexHeight)
        val first=(parent.layoutManager as LinearLayoutManager).findFirstVisibleItemPosition()
        if(first<0){
            return
        }
        var moveY=0;
        val next=findNextIndex(first,parent)
        if(next!=first){
            val holder=parent.findViewHolderForAdapterPosition(next)
            if(holder.itemView.top<indexHeight*2){
                moveY=holder.itemView.top-indexHeight*2;
            }
        }
        floatRect.offset(0,moveY)
        drawFloatingBg(c,floatRect,paintFloatBg)
        drawFloatingBgText(c,getDrawText(datas.get(first)),floatingTextLeft,floatRect.bottom-(indexHeight-textHeight)/2f,paintFloatBgText,floatRect)
    }

    //找到下一个带索引的item的position
    fun findNextIndex(position: Int,parent: RecyclerView):Int{
        for(i in position+1 until parent.adapter.itemCount){
            if(!indexEqual(datas.get(i-1),datas.get(i))){
                return i;
            }
        }
        return position
    }
}

上边是抽象类，因为不知道实体对象到底要的索引是啥。
下边来个联系人的简单实现，抽闲类公开了initSomething方法，可以修改paint的属性。
drawBG,drawBgText也公开了，可以自己修改。

import android.graphics.Canvas
import android.graphics.Color
import android.graphics.Paint
import android.graphics.Rect
import android.text.TextUtils

class ItemDecorationC:ItemDecorationContact<Contact>(){
    override fun getDrawText(t: Contact): CharSequence {
        return t.index
    }

    override fun indexEqual(t: Contact, t1: Contact): Boolean {
        return TextUtils.equals(t.index.substring(0,1),t1.index.substring(0,1))
    }

    override fun drawFloatingBgText(c: Canvas, text: CharSequence, x: Float, y: Float, paint: Paint, rect: Rect) {
        val radius=indexHeight/2-6f
        //重写以下，原本的文字是从左边开始的，这里要添加的一个圆圈，所以从圆的中心开始画，因此在init方法里重新设置了paint的textAlign属性
        c.drawText(text,0,1,x+radius,y,paintFloatBgText)
        c.drawCircle(x+radius,rect.centerY().toFloat(),radius,paintCircle)//文字的y值是修正过的，在中心点下边一点，所以这里不能用那个y
    }
    val paintCircle=Paint(Paint.ANTI_ALIAS_FLAG)
    override fun initSomeThing() {
        super.initSomeThing()
        paintFloatBgText.textAlign=Paint.Align.CENTER
        paintCircle.color=Color.WHITE
        paintCircle.style=Paint.Style.STROKE
        paintCircle.strokeWidth=2f
    }
}

这里简单分析下drawOver那里的偏移量。

 val holder=parent.findViewHolderForAdapterPosition(next)
            if(holder.itemView.top<indexHeight*2){
                moveY=holder.itemView.top-indexHeight*2;
            }

image.png

可能有人说这些玩意不能设置点击事件

那个你真需要可以通过SimpleOnItemTouchListener 来处理啊，坐标都给你了。自然可以算出来到底点的是哪里。
也就能做对应的处理拉。

看下itemDecoration啥时候画的

在recyclerview里，我们知道onDraw是通过draw方法调用的，也就是下边的super.draw(c)调用的，所以
代码1先执行的，之后大家知道会执行dispatchDraw绘制子view，也就是我们的item了。这下super.draw(c)执行完了
最后执行代码2。
所以现在知道了ItemDecoration的ondraw是画在最底层的，上边是itemview，然后最上边是drawOver画的东西

    public void draw(Canvas c) {
        super.draw(c);

        final int count = mItemDecorations.size();
        for (int i = 0; i < count; i++) {
            mItemDecorations.get(i).onDrawOver(c, this, mState);//代码2
        }

    public void onDraw(Canvas c) {
        super.onDraw(c);

        final int count = mItemDecorations.size();
        for (int i = 0; i < count; i++) {
            mItemDecorations.get(i).onDraw(c, this, mState);//代码1
        }
    }

看下效果图，可以看到带图片的itemview明显在ItemDecoration的ondraw上边，图上的itemview是没有背景的，白色是activity的背景。

image.png

如果研究过draw,onDraw啥时候调用的人可能会有疑问的，recyclerview并没有设置背景，为啥onDraw会执行，我记得我们以前学的时候是 如果viewgroup没有设置背景的话，是不会走onDraw方法的，可这里走了。

网上找了篇帖子，可以看下http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2014/1014/1765.html

然后我们在recyclerview的构造方法里可以找到这样代码

setWillNotDraw(getOverScrollMode() == View.OVER_SCROLL_NEVER);

括号里的值是个false的，所以会执行onDraw的》 OVER_SCROLL_NEVER==2，而前者没有初始化，就是个0，所以不等

DividerItemDecoration待研究

哎，竟然不知道系统提供了一个默认的实现。
使用起来也比较简单，如下代码，下图这种默认使用的是主题里系统的图片
可以自定义，如下

<item name="android:listDivider">@drawable/divider_normal_gray</item>

addItemDecoration(DividerItemDecoration(activity,LinearLayout.VERTICAL))

或者你也可以直接setDrawable给DividerItemDecoration弄个线条