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

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

项目地址

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

  • LinearLayoutManager
  • GridLayoutManager (水平方向粘性头部暂未实现)
  • StaggeredGridLayoutManager (粘性头部暂未实现)

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

先上效果图

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

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

使用

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

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
复制代码

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

dependencies {
    ...
    implementation 'com.github.arvinljw:ItemDecorationHelper:v1.0.3'
    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,然后重写getItemOffsetsonDraw方法,实现分割线的绘制,通过重写onDrawOver实现粘性头部。

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

很直观,可以看到不同内容绘制在不同层次,位置重合的话,上层会覆盖下层的内容。

具体的实现全是根据这个逻辑计算绘制。其中为了保持平分内容,将分割线拆分,如图:感谢RecyclerView的 GridItemDecoration等分itemView

具体的难点就在这两个位置。

至于粘性头部,核心逻辑就是对数据的分组以及头部的偏移计算和绘制。也是万变不离其中。具体的实现请参考源码,含有一定的注释。

感谢

RecyclerView 悬浮/粘性头部——StickyHeaderDecoration

【Android】RecyclerView:打造悬浮效果

RecyclerView的 GridItemDecoration等分itemView

在实现过程中参考了很多文章,如果没有注明来源的,麻烦指出来,会直接加上引用来源的。

源码

项目地址

之后文章的更新都以项目的README为准。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值