前言

RecyclerView.ItemDecoration，通過名字來看，它就是用來裝飾Item的。
在類ListView的檢視中，可能需要繪製分隔線；在類GridView的網格檢視中，可能需要繪製單元格樣式… 這些都可以由重寫RecyclerView.ItemDecoration來進行定製。
然後呼叫mRecyclerView.addItemDecoration(itemDecoration); 即可

分析

看下RecyclerView.ItemDecoration的原始碼：

public static abstract class ItemDecoration {

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


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


    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, State state) {
        getItemOffsets(outRect, ((LayoutParams) view.getLayoutParams()).getViewLayoutPosition(),
                parent);
    }
}
 

這裡找的是，support-v7-25.3.1的RecyclView原始碼，去除了已過時的方法。

關於這三方法的作用：

• onDraw
  它在item之前繪製，就像裝飾了一個item的背景，在item之前繪製

• onDrawOver
  它在item之後繪製，就像裝飾了一個item的前景，在item之後繪製

• getItemOffsets
  指定item間的偏移量。由指定outRect的left、top、right、bottom的畫素值，來偏移item。指定了偏移量後，可能會影響item的寬或高。

這三個方法的執行順序：getItemOffsets > onDraw > onDrawOver

ItemDecoration示例

DividerItemDecoration

DividerItemDecoration，在support-v7中已經集成了。全稱 android.support.v7.widget.DividerItemDecoration。

通過通的註釋可知，它是用於在LinearLayoutManager所管理的item之間新增分隔線。

詳細程式碼就不貼了。值得一提的是，它裡面使用了一個系統屬性來指定drawable資源：private static final int[] ATTRS = new int[]{ android.R.attr.listDivider };。 一般在ListView中我們就經常使用一個xml屬性：android:divider。而這裡的屬性android.R.attr.listDivider對應的是android:listDivider。
所以在styles.xml 中就可以定義這個屬性：

<resources>
  <style ...>   
    <item name="android:listDivider">@drawable/divider_hori</item>
  </style>
</resources>

效果圖：

這條 藍紅綠顏色漸變的水平線，就是@drawable/divider_hori
 

GridDecoration

當使用GridLayoutManager時，想在每個item外繪製一個矩形框。
實現：重寫RecyclerView.ItemDecoration的onDraw，繪製矩形框；重寫getItemOffsets，指定item間偏移量。

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

    Paint paint = new Paint();
    paint.setColor(mBackColor);

    for (int i = 0, len = parent.getLayoutManager().getChildCount(); i < len; i++) {
        final View child = parent.getChildAt(i);

        int offset = 5;
        float left = child.getLeft() - offset;
        float top = child.getTop() - offset;
        float right = child.getRight() + offset;
        float bottom = child.getBottom() + offset;

        c.drawRect(left, top, right, bottom, paint);
    }
}

@Override
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
     outRect.offset(20, 30);

     int position = parent.getChildAdapterPosition(view);
     if (position % 2 == 1) {
         outRect.offsetTo(100, 20);
     }
 }

效果圖：

圖中每個item外的 淡藍色的框，就是通過ItemDecoration#onDraw()繪製的。