RecyclerView设置分割线（自定义宽度与颜色）

RecyclerView自出现后，越来越受到欢迎，源自其强大的扩展性。网上关于RecyclerView用法的文章有很多，我再这里就不再重复搬砖了。在我的使用过程中，就是使用分割线方面还有些生涩，经过网上查阅文章，特做此记录。

一、DividerItemDecoration

官方已经在v7包中提供了分割线的类，即android.support.v7.widget.DividerItemDecoration，它的使用范围：

DividerItemDecoration is a {@link RecyclerView.ItemDecoration} that can be used as a divider
between items of a {@link LinearLayoutManager}. It supports both {@link #HORIZONTAL} and
  {@link #VERTICAL} orientations.
 
 mDividerItemDecoration = new DividerItemDecoration(recyclerView.getContext(),
              mLayoutManager.getOrientation());
 recyclerView.addItemDecoration(mDividerItemDecoration);

它适用于LinearLayoutManager，对于GridLayoutManager就无能为力了。同时，如果想要修改分割线的宽度及颜色，需要在主题中设置listDivider属性，并引用自己定义的分割线样式。

public class DividerItemDecoration extends RecyclerView.ItemDecoration {

    private static final int[] ATTRS = new int[]{ android.R.attr.listDivider };
	......
    public DividerItemDecoration(Context context, int orientation) {
        final TypedArray a = context.obtainStyledAttributes(ATTRS);
        mDivider = a.getDrawable(0);
        a.recycle();
        setOrientation(orientation);
    }
    .....

 <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="android:listDivider">@drawable/divider_bg</item>
    </style>

divider_bg.xml

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="@color/gray_home_light"/>
    <size android:height="3dp" android:width="3dp"/>
</shape>

当然如果没有设置listDivider属性，就会使用系统默认的。
但是如果一个主题下面需要定义多个分割线宽度或者颜色的话，利用设置listDivider属性的方法的话，就有些力所不逮了。
有如下两种方式：

1、利用DividerItemDecoration中提供的setDrawable方法即可实现自定义分割线

具体方法如下：

    /**
     * Sets the {@link Drawable} for this divider.
     *
     * @param drawable Drawable that should be used as a divider.
     */
    public void setDrawable(@NonNull Drawable drawable) {
        if (drawable == null) {
            throw new IllegalArgumentException("Drawable cannot be null.");
        }
        mDivider = drawable;
    }

实现步骤如下：
（1）自定义drawable

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <!--分割线的高度，横向的RecyclerView,这里设置宽度即可-->
    <size android:height="1dp" android:width="1dp"/>
    <!--分割线的颜色-->
    <solid android:color="@color/gray" />
</shape>

（2）引用并设置drawable

DividerItemDecoration decoration = new DividerItemDecoration(mContext, DividerItemDecoration.HORIZONTAL);
Drawable drawable = getResources().getDrawable(R.drawable.divider_recyclerview);
decoration.setDrawable(drawable);

（3）将DividerItemDecoration设置给RecyclerView

mRecyclerView.addItemDecoration(decoration);

利用上面的方法就可以实现自定义分割线了。当然也可以采用如下的方法

2、自定义DividerItemDecoration

对DividerItemDecoration修改如下：

public class DividerItemDecoration extends RecyclerView.ItemDecoration {

    private static final int[] ATTRS = new int[]{
            android.R.attr.listDivider
    };
	.....
    public DividerItemDecoration(Context context, int orientation) {
        final TypedArray a = context.obtainStyledAttributes(ATTRS);
        mDivider = a.getDrawable(0);
        a.recycle();
        setOrientation(orientation);
    }

    public DividerItemDecoration(Context context, int orientation, int drawableId){
        mDivider = context.getResources().getDrawable(drawableId);
        setOrientation(orientation);
    }
    ......

增加了一个构造方法，可以将自己定义的样式直接传入。

二、针对最后一行不显示分割线的需求

有很多时候，我们会有最后一行不显示分割线的需求，但是系统默认的分割线显然不满足此需求。通过参考网上的文章，发现只需要修改drawHorizontal中就可以实现。在此，我以GridLayoutManager对应的分割线为例。
DividerGridItemDecoration（源自鸿洋大神的Android RecyclerView 使用完全解析 体验艺术般的控件）

private static final int[] ATTRS = new int[] { android.R.attr.listDivider };
    private Drawable mDivider;
    private boolean mShowLastLine;

    public DividerGridItemDecoration(Context context) {
        final TypedArray a = context.obtainStyledAttributes(ATTRS);
        mDivider = a.getDrawable(0);
        a.recycle();
    }

    public DividerGridItemDecoration(Context context, boolean showLastLine) {
        final TypedArray a = context.obtainStyledAttributes(ATTRS);
        mDivider = a.getDrawable(0);
        mShowLastLine = showLastLine;
        a.recycle();
    }

    public DividerGridItemDecoration(Context context, int drawableId){
        mDivider = context.getResources().getDrawable(drawableId);
    }

    public DividerGridItemDecoration(Context context, int drawableId, boolean showLastLine){
        mDivider = context.getResources().getDrawable(drawableId);
        mShowLastLine = showLastLine;
    }
    .....
    
    private void drawHorizontal(Canvas c, RecyclerView parent) {
        int childCount;
        if(mShowLastLine) {
            childCount = parent.getChildCount();
        }else {
            int spanCount = getSpanCount(parent);
            int count = parent.getChildCount();
            childCount = count - (count % spanCount == 0? spanCount : count%spanCount);
        }

        for (int i = 0; i < childCount; i++)
        {
            final View child = parent.getChildAt(i);
            final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
                    .getLayoutParams();
            final int left = child.getLeft() - params.leftMargin;
            final int right = child.getRight() + params.rightMargin
                    + mDivider.getIntrinsicWidth();
            final int top = child.getBottom() + params.bottomMargin;
            final int bottom = top + mDivider.getIntrinsicHeight();
            mDivider.setBounds(left, top, right, bottom);
            mDivider.draw(c);
        }
    }
    ......

通过一个布尔值，进行控制是否显示最后一样的分割线。当然，我写的是竖直方向上的水平分割线，水平方向上的竖直分割线同理。

三、总结

通过上面两步的改造，很多需求都可以满足了。
如果需要DividerGridItemDecoration的代码，就去 鸿洋大神的博客 上看看吧。具体的改造根据上文进行就可以了。

参考文章：
Android RecyclerView 使用完全解析 体验艺术般的控件