ItemDecoration实践之分割线与粘性头部

RecyclerView提供了良好的设计，将各部分功能的实现都拆解开，方便自定义，虽然加大了使用难度，但是却大大的增加了可扩展性，稍微会使用之后，扩展起来非常的舒心。

项目地址

功能：适用于以下几种布局的分割线和粘性头部

LinearLayoutManager
GridLayoutManager （水平方向粘性头部暂未实现）
StaggeredGridLayoutManager （粘性头部暂未实现）

对于分割线，与大多数的实现不同，在GridLayoutManager和StaggeredGridLayoutManager布局时是平分Item的，分割线大的时候就能发现

先上效果图

image.png

注意：其中这三种布局的分割线不管是水平还是垂直方向都是支持的，但是带有header的只支持LinearLayoutManager的水平和垂直以及GridLayoutManager垂直方向

还可以下载Demo在手机上预览一下。

使用

1、在根目录的build.gradle中加入如下配置

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

2、在要用的module中增加如下引用

dependencies {
    ...
    implementation 'com.github.arvinljw:ItemDecorationHelper:v1.0.5'
    implementation 'com.android.support:recyclerview-v7:'.concat(supportVersion)
}

其中supportVersion换成自己app中的版本即可

3、为RecyclerView添加ItemDecoration，通过ItemDecorationFactory生成包括分割线的ItemDecoration和粘性头部的ItemDecoration，后者包含了分割线

ItemDecorationFactory.DividerBuilder 分割线

itemDecoration = new ItemDecorationFactory.DividerBuilder()
        .dividerHeight(2)
        .dividerColor(Color.parseColor("#D8D8D8"))
        .showLastDivider(false)//默认是true
        .build(recyclerView);
recyclerView.addItemDecoration(itemDecoration);

ItemDecorationFactory.StickyDividerBuilder 粘性头部

itemDecoration = new ItemDecorationFactory.StickyDividerBuilder()
        .dividerHeight(2)
        .dividerColor(Color.parseColor("#D8D8D8"))
        .callback(new StickyDividerCallback() {
            @Override
            public GroupData getGroupData(int position) {
                //生成GroupData
                return data;
            }
            @Override
            public View getStickyHeaderView(int position) {
                    //...生成headerView
                return headerView;
            }
        }).build(recyclerView);
recyclerView.addItemDecoration(itemDecoration);

其中如果是粘性头部，需要自己生成GroupData和自定义View的设置，GroupData需要设置，分组标题，在分组中的位置以及该分组的长度；至于如何实现，需要根据数据格式定义不同的逻辑，可以参照demo中的实现逻辑去获取，该类的getItemDecoration方法。

对于分割线没啥说的，可以设置分割线的颜色和大小。

默认头部

其中对于显示分组头部，有一个默认实现DefaultHeaderCallBack，只需要重写分组数据即可。例如：

headerCallBack = new DefaultHeaderCallBack(this) {
    @Override
    public GroupData getGroupData(int position) {
        //生成GroupData
        return data;
    }
};

注意如果添加在Adapter中添加了emptyView，那么这个时候其实是没有数据项的，所以在getGroupData方法中返回null即可

头部点击事件

为头部增加点击事件，其中回调中的position是当前header所在的item的实际位置。

((BaseStickyDividerItemDecoration) itemDecoration).setOnHeaderClickListener(new OnHeaderClickListener() {
    @Override
    public void onHeaderClicked(int position) {
        //TODO
    }
});

注意：在界面被销毁时，调用headerCallBack的onDestroy方法，避免内存泄漏。

代码混淆

-keep class net.arvin.itemdecorationhelper.**{*;}

TODO

优化实现方式

原理

继承ItemDecoration，然后重写getItemOffsets和onDraw方法，实现分割线的绘制，通过重写onDrawOver实现粘性头部。

原理很简单，就是首先让itemView在你需要的方向偏移，例如left，top，right，botton；然后再在onDraw或者onDrawOver方法中获取到当前屏幕的view，并根据他们的位置，按照偏移的逻辑在相应区域绘制即可。借用一张图，感谢【Android】RecyclerView：打造悬浮效果。