问色录,衡水中学高考成绩,齐齐哈尔完美生活
前言
前段时间需要用到recyclerview，就想找个封装好的下拉刷新，上拉加载的库，结果愣是没找到，便自己写了一个。
注意：我说的是“上拉加载”，不是滑到底部自动加载。 虽然现在自动加载是主流和趋势，但也不排除有时候就需要用到上拉加载啊，毕竟林子大了，什么样的产品经理都有对吧。
代码写好后，准备发布到bintray的时候，向同事征求这个项目的名字，同事说：“就叫dztrecyclerview!” 不解，同事解释：“叼炸天recyclerview！” 多么酷炫奢华有内涵！！于是，这个库就叫做wzmrecyclerview，恩，名字缩写就可以了，毕竟配不上dzt这个名字。
这篇文章先介绍如何使用这个recyclerview，之后如果我懒癌没有发作的话，再详细依次介绍整个项目的实现。
好了，进入正题。
简介
wzmrecyclerview 是一个集成了 下拉刷新、上拉加载、滑到底部自动加载、添加删除头尾部 四个主要功能的recyclerview，当然，还支持 自定义的刷新头部和加载底部、emptyview、loadingview、封装后的简单易用的adapter、封装后的简单易用的分割线等。
下面依次介绍：
1. 添加删除头尾部和点击事件
2. 下拉刷新
3. 上拉加载
4. 滑动到底部自动加载
5. 使用自定义的下拉刷新头部
6. 使用自定义的上拉加载尾部
7. 使用自定义的自动加载尾部
由于这个项目有四个主要功能，我没有采用全部集成在一个recyclerview的方式，而是采用继承的方式依次实现每个功能。继承关系如下：
headerandfooterrecyclerview –> pulltorefreshrecyclerview –> pulltoloadrecyclerview，而autoloadrecyclerview也是继承自pulltorefreshrecyclerview.
因此，要是你问我headerandfooterrecyclerview鸡不鸡齐下拉刷新，那当然是不鸡齐的！但pulltorefreshrecyclerview是鸡齐添加删除头尾部的。
使用
使用这个库，使用android studio的同学先要在build.gradle加上依赖：
compile 'com.mrw:wzmrecyclerview:1.0.2'
使用eclipse的同学，可以上github把项目clone下来。当然，更好的办法是赶紧换成android studio。
添加删除头尾部和点击事件
headerandfooterrecyclerview.addheaderview(headerview);//添加头部 headerandfooterrecyclerview.removeheaderview(headerview);//删除头部 headerandfooterrecyclerview.addfooterview(footerview);//添加尾部 headerandfooterrecyclerview.removefooterview(footerview);//删除尾部 headerandfooterrecyclerview.setonitemclicklistener(onitemclicklistener onitemclicklistener);//添加item点击事件监听 headerandfooterrecyclerview.setonitemlongclicklistener(onitemlongclicklistener onitemlongclicklistener);//添加item点击事件监听
和listview的用法一致，就不详细说了。效果图:
头尾部
grid头尾部
staggred头尾部
下拉刷新
下拉刷新直接使用pulltorefreshrecyclerview就可以了，这里提供了几个方法：
pulltorefreshrecyclerview.setonrefreshlistener(onrefreshlistener onrefreshlistener);//添加下拉刷新监听 pulltorefreshrecyclerview.setrefreshviewcreator(refreshheadercreator refreshheadercreator);//使用自定义的下拉刷新头部 pulltorefreshrecyclerview.setrefreshenable(boolean refreshenable);//下拉刷新是否可用 pulltorefreshrecyclerview.setpullratio(float pullratio);//设置下拉阻尼系数 pulltorefreshrecyclerview.completerefresh();//完成刷新
一般使用过程中，使用setonrefreshlistener监听下拉刷新，然后刷新完成后调用completerefresh方法完成刷新就可以了。
上拉加载
上拉加载使用pulltoloadrecyclerview，提供的方法如下：
pulltoloadrecyclerview.setonloadlistener(onloadlistener onloadlistener);//添加上拉加载监听 pulltoloadrecyclerview.setloadviewcreator(loadfootercreator loadviewcreator);//使用自定义的上拉加载尾部 pulltoloadrecyclerview.setloadenable(boolean loadmoreenable);//上拉加载是否可用 pulltoloadrecyclerview.setpullloadratio(float loadratio);//设置上拉阻尼系数 pulltoloadrecyclerview.completeload();//完成加载
一般使用过程中，使用setonloadlistener监听上拉加载，然后加载完成后调用completeload方法完成加载就可以了。
注意：上拉加载中的layoutmanager推荐使用wzmlinearlayoutmanager、wzmgridlayoutmanager, 至于原因会在后面的文章中说明。
效果图:
刷新加载
grid刷新加载
staggred刷新加载
滑动到底部自动加载
自动加载使用autoloadrecyclerview，提供的方法如下：
autoloadrecyclerview.setonloadlistener(onloadlistener onloadlistener);//添加加载监听 autoloadrecyclerview.setautoloadviewcreator(autoloadfootercreator autoloadfootercreator);//使用自定义的自动加载尾部 autoloadrecyclerview.completeload();//完成加载 autoloadrecyclerview.setnomore(boolean nomore);//设置没有更多数据
一般使用过程中，使用setonloadlistener监听自动加载，然后加载完成后调用completeload方法完成加载，当没有更多数据时，调用setnomore方法就可以了。
效果图：
grid自动加载
使用自定义的下拉刷新头部
所有不支持自定义刷新加载view的项目都是耍流氓，所以，我们支持了自定义的刷新头部和加载尾部。这句话有没有老罗的感觉？
自定义的下拉刷新头部其实很简单，如果你看了上面下拉刷新的介绍，你会发现一个方法：
pulltorefreshrecyclerview.setrefreshviewcreator(refreshheadercreator refreshheadercreator);//使用自定义的下拉刷新头部
没错，这个就是设置自定义下拉刷新头部的方法，那个这个refreshheadercreator到底是个什么东西呢？其实它是个抽象类，你只要继承它实现抽象方法就可以了，它有三个方法需要实现：
/** * 下拉 * @param distance 距离 * @return 下拉距离，返回true表示可以继续下拉 */ public abstract boolean onstartpull(float distance, int laststate); /** * 松手刷新 * @param distance 距离 * @return 下拉距离，返回true表示可以继续下拉 */ public abstract boolean onreleasetorefresh(float distance,int laststate); /**开始刷新*/ public abstract void onstartrefreshing(); /**刷新结束*/ public abstract void onstoprefresh();
是不是炒鸡简单？
继承refreshheadercreator
调用setrefreshviewcreator方法
没了
其中onstartpull方法是指下拉过程，传入两个参数：一个距离(distance)，一个是上次的状态(laststate)。distance可以让你自己根据距离完成自己的下拉头部内部的动画，laststate让你知道”下拉刷新”、”松手立即刷新”两个状态的切换。
onreleasetorefresh和onstartpull是一样的。
使用自定义的上拉加载尾部
这个其实和自定义的下拉刷新头部是一样样的，
pulltoloadrecyclerview.setloadviewcreator(loadfootercreator loadviewcreator);//使用自定义的上拉加载尾部
来看看这个loadfootercreator：
/** * 上拉 * @param distance 距离 * @return 是否继续上拉 */ protected abstract boolean onstartpull(float distance,int laststate); /** * 松手加载 * @param distance 距离 * @return 是否继续上拉 */ protected abstract boolean onreleasetoload(float distance,int laststate); /**开始加载*/ protected abstract void onstartloading(); /**加载结束*/ protected abstract void onstopload();
哦，和refreshheadercreator一毛一样，那就不说了。
使用自定义的自动加载尾部
还是一样:
autoloadrecyclerview.setautoloadviewcreator(autoloadfootercreator autoloadfootercreator);//使用自定义的自动加载尾部
看看autoloadfootercreator：
/*** * 获得footer */ protected abstract view getloadview(context context, recyclerview recyclerview); /*** * 没有更多 */ protected abstract view getnomoreview(context context,recyclerview recyclerview);
恩，更简单了，就两个方法，获得加载中的尾部、没有更多的尾部。
so easy！！
后记
在之后，我会抽时间对这个项目的实现过程进行详细的介绍。
源码地址：https://github.com/whichname/wzmrecyclerview
如对本文有疑问，请在下面进行留言讨论，广大热心网友会与你互动！！ 点击进行留言回复
Android studio开发小型对话机器人app(实例代码)
Android通过Java sdk的方式接入OpenCv的方法
Android 通过cmake的方式接入opencv的方法步骤
Android Studio finish()方法的使用与解决app点击“返回”(直接退出)
Android 进度条 ProgressBar的实现代码(隐藏、出现、加载进度)
我要评论
网友评论