优雅地刷新RecyclerView

前言

还是那句话,RecyclerView的viewType增多,逻辑变复杂,几个月后,你确定还能理清思路吗?假设我们服务端是多个接口返回数据,你确定能正确刷新相应type吗?想一个RecyclerView高效快捷管理整个界面吗?你还在使用notifyDataSetChanged无脑刷新吗?你想单个viewType在loadingView,dataView,errorView自如切换吗?如果你迟疑了,那你不妨试试本库。

特点

  • 与Adapter为组合关系,可配合大多数Adapter
  • 一行代码刷新相应viewType
  • 支持facebook的shimmer加载效果
  • 支持粘性头
  • 支持异步刷新,可扩展(如配合RxAndroid)
  • 支持加载相应type错误页面
  • 支持高频率刷新(流畅,异步执行)

效果

线性排布

image

方格排布

image

关键字高亮

image

刷新错误页面

image

高频率刷新

image

更新内容

  • 支持刷新type错误页面(可自定义)
  • 支持同时刷新多个type(异步,高频率)
  • 链式注册资源
  • 支持刷新单个数据
  • 提供helper的清除单个type,清除整个界面api
  • 提供getHeaderId的默认实现抽象类

支持刷新type错误页面(可自定义)

image.png

一行代码搞定,前者提供实体类是考虑有些用户需要根据实体数据属性去更新,因此错误页面的layoutId是用户提供的。

支持同时刷新多个type(异步,高频率)

image.png

这里采用的是队列的形式管理刷新,提供清空队列的Api。

链式注册资源

image.png

由于参数越来越多,这里采用了较为流行的链式注册,内部通过ResourcesManager管理所有资源。

**注:**原来的注册方式已设置为过时,请及时更新,不出2个版本将移除。

支持刷新单个数据

image.png

可能某个type只有一个实体数据管理着整个type

image.png

可传T的子类集合

提供helper的清除单个type,清除整个界面api

image.png

提供getHeaderId的默认实现抽象类

假设你不实现粘性头而强制要写getHeaderId确实挺讨厌的,由于现在android还不是很好地兼容java8,因此暂时提供DefaultMultiHeaderEntity。

使用注意点

type 取值范围

  • level [0,+∞)
  • 数据类型 [0,1000)
  • 头类型 [-1000,0)
  • shimmer数据类型 [-2000,-1000)
  • shimmer头类型 [-3000,-2000)
  • error类型 [-4000,-3000)

常量差值

image.png

结束

库多多少少也更新几个版本了,你的意见,你的建议,你的star,你的分享,一直是我前进的动力。还有一点要说的就是现在关于LayoutManager,RecyclerView,Adapter的流派很多,我们更关注于数据的优雅刷新。

gradle依赖

image.png

猜你喜欢

转载自juejin.im/post/5bd07a6ef265da0af334b6a4