前言

前段時(shí)間需要用到recyclerview，就想找個(gè)封裝好的下拉刷新，上拉加載的庫(kù)，結(jié)果愣是沒(méi)找到，便自己寫(xiě)了一個(gè)。

注意：我說(shuō)的是“上拉加載”，不是滑到底部自動(dòng)加載。 雖然現(xiàn)在自動(dòng)加載是主流和趨勢(shì)，但也不排除有時(shí)候就需要用到上拉加載啊，畢竟林子大了，什么樣的產(chǎn)品經(jīng)理都有對(duì)吧。

代碼寫(xiě)好后，準(zhǔn)備發(fā)布到bintray的時(shí)候，向同事征求這個(gè)項(xiàng)目的名字，同事說(shuō)：“就叫DZTRecyclerview!” 不解，同事解釋?zhuān)骸暗鹫ㄌ霷ecyclerview！” 多么酷炫奢華有內(nèi)涵！！于是，這個(gè)庫(kù)就叫做WZMRecyclerview，恩，名字縮寫(xiě)就可以了，畢竟配不上DZT這個(gè)名字。

這篇文章先介紹如何使用這個(gè)recyclerview，之后如果我懶癌沒(méi)有發(fā)作的話，再詳細(xì)依次介紹整個(gè)項(xiàng)目的實(shí)現(xiàn)。

好了，進(jìn)入正題。

簡(jiǎn)介

WZMRecyclerview 是一個(gè)集成了 下拉刷新、上拉加載、滑到底部自動(dòng)加載、添加刪除頭尾部 四個(gè)主要功能的recyclerview，當(dāng)然，還支持 自定義的刷新頭部和加載底部、EmptyView、LoadingView、封裝后的簡(jiǎn)單易用的adapter、封裝后的簡(jiǎn)單易用的分割線等。

下面依次介紹：

1. 添加刪除頭尾部和點(diǎn)擊事件
2. 下拉刷新
3. 上拉加載
4. 滑動(dòng)到底部自動(dòng)加載
5. 使用自定義的下拉刷新頭部
6. 使用自定義的上拉加載尾部
7. 使用自定義的自動(dòng)加載尾部

由于這個(gè)項(xiàng)目有四個(gè)主要功能，我沒(méi)有采用全部集成在一個(gè)recyclerview的方式，而是采用繼承的方式依次實(shí)現(xiàn)每個(gè)功能。繼承關(guān)系如下：

HeaderAndFooterRecyclerView –> PullToRefreshRecyclerView –> PullToLoadRecyclerView，而AutoLoadRecyclerview也是繼承自PullToRefreshRecyclerView.

因此，要是你問(wèn)我HeaderAndFooterRecyclerView雞不雞齊下拉刷新，那當(dāng)然是不雞齊的！但PullToRefreshRecyclerView是雞齊添加刪除頭尾部的。

使用

使用這個(gè)庫(kù)，使用Android studio的同學(xué)先要在build.gradle加上依賴：

compile 'com.mrw:wzmrecyclerview:1.0.2'

使用eclipse的同學(xué)，可以上github把項(xiàng)目clone下來(lái)。當(dāng)然，更好的辦法是趕緊換成android studio。

添加刪除頭尾部和點(diǎn)擊事件

HeaderAndFooterRecyclerView.addHeaderView(HeaderView);//添加頭部
HeaderAndFooterRecyclerView.removeHeaderView(HeaderView);//刪除頭部
HeaderAndFooterRecyclerView.addFooterView(FooterView);//添加尾部
HeaderAndFooterRecyclerView.removeFooterView(FooterView);//刪除尾部
HeaderAndFooterRecyclerView.setOnItemClickListener(OnItemClickListener onItemClickListener);//添加item點(diǎn)擊事件監(jiān)聽(tīng)
HeaderAndFooterRecyclerView.setOnItemLongClickListener(OnItemLongClickListener onItemLongClickListener);//添加item點(diǎn)擊事件監(jiān)聽(tīng)

和ListView的用法一致，就不詳細(xì)說(shuō)了。效果圖:

頭尾部

Grid頭尾部

Staggred頭尾部

下拉刷新

下拉刷新直接使用PullToRefreshRecyclerView就可以了，這里提供了幾個(gè)方法：

PullToRefreshRecyclerView.setOnRefreshListener(OnRefreshListener onRefreshListener);//添加下拉刷新監(jiān)聽(tīng)
PullToRefreshRecyclerView.setRefreshViewCreator(RefreshHeaderCreator refreshHeaderCreator);//使用自定義的下拉刷新頭部
PullToRefreshRecyclerView.setRefreshEnable(boolean refreshEnable);//下拉刷新是否可用
PullToRefreshRecyclerView.setPullRatio(float pullRatio);//設(shè)置下拉阻尼系數(shù)
PullToRefreshRecyclerView.completeRefresh();//完成刷新

一般使用過(guò)程中，使用setOnRefreshListener監(jiān)聽(tīng)下拉刷新，然后刷新完成后調(diào)用completeRefresh方法完成刷新就可以了。

上拉加載

上拉加載使用PullToLoadRecyclerView，提供的方法如下：

PullToLoadRecyclerView.setOnLoadListener(OnLoadListener onLoadListener);//添加上拉加載監(jiān)聽(tīng)
PullToLoadRecyclerView.setLoadViewCreator(LoadFooterCreator loadViewCreator);//使用自定義的上拉加載尾部
PullToLoadRecyclerView.setLoadEnable(boolean loadMoreEnable);//上拉加載是否可用
PullToLoadRecyclerView.setPullLoadRatio(float loadRatio);//設(shè)置上拉阻尼系數(shù)
PullToLoadRecyclerView.completeLoad();//完成加載

一般使用過(guò)程中，使用setOnLoadListener監(jiān)聽(tīng)上拉加載，然后加載完成后調(diào)用completeLoad方法完成加載就可以了。

注意：上拉加載中的LayoutManager推薦使用WZMLinearLayoutManager、WZMGridLayoutManager, 至于原因會(huì)在后面的文章中說(shuō)明。

效果圖:

刷新加載

Grid刷新加載

Staggred刷新加載

滑動(dòng)到底部自動(dòng)加載

自動(dòng)加載使用AutoLoadRecyclerView，提供的方法如下：

AutoLoadRecyclerView.setOnLoadListener(OnLoadListener onLoadListener);//添加加載監(jiān)聽(tīng)
AutoLoadRecyclerView.setAutoLoadViewCreator(AutoLoadFooterCreator autoLoadFooterCreator);//使用自定義的自動(dòng)加載尾部
AutoLoadRecyclerView.completeLoad();//完成加載
AutoLoadRecyclerView.setNoMore(boolean noMore);//設(shè)置沒(méi)有更多數(shù)據(jù)

一般使用過(guò)程中，使用setOnLoadListener監(jiān)聽(tīng)自動(dòng)加載，然后加載完成后調(diào)用completeLoad方法完成加載，當(dāng)沒(méi)有更多數(shù)據(jù)時(shí)，調(diào)用setNoMore方法就可以了。

效果圖：

Grid自動(dòng)加載

使用自定義的下拉刷新頭部

所有不支持自定義刷新加載view的項(xiàng)目都是耍流氓，所以，我們支持了自定義的刷新頭部和加載尾部。這句話有沒(méi)有老羅的感覺(jué)？

自定義的下拉刷新頭部其實(shí)很簡(jiǎn)單，如果你看了上面下拉刷新的介紹，你會(huì)發(fā)現(xiàn)一個(gè)方法：

PullToRefreshRecyclerView.setRefreshViewCreator(RefreshHeaderCreator refreshHeaderCreator);//使用自定義的下拉刷新頭部

沒(méi)錯(cuò)，這個(gè)就是設(shè)置自定義下拉刷新頭部的方法，那個(gè)這個(gè)RefreshHeaderCreator到底是個(gè)什么東西呢？其實(shí)它是個(gè)抽象類(lèi)，你只要繼承它實(shí)現(xiàn)抽象方法就可以了，它有三個(gè)方法需要實(shí)現(xiàn)：

/**
* 下拉
* @param distance 距離
* @return 下拉距離，返回true表示可以繼續(xù)下拉
*/
public abstract boolean onStartPull(float distance, int lastState);
/**
* 松手刷新
* @param distance 距離
* @return 下拉距離，返回true表示可以繼續(xù)下拉
*/
public abstract boolean onReleaseToRefresh(float distance,int lastState);
/**開(kāi)始刷新*/
public abstract void onStartRefreshing();
/**刷新結(jié)束*/
public abstract void onStopRefresh();

是不是炒雞簡(jiǎn)單？

繼承RefreshHeaderCreator

調(diào)用setRefreshViewCreator方法

沒(méi)了

其中onStartPull方法是指下拉過(guò)程，傳入兩個(gè)參數(shù)：一個(gè)距離(distance)，一個(gè)是上次的狀態(tài)(lastState)。distance可以讓你自己根據(jù)距離完成自己的下拉頭部?jī)?nèi)部的動(dòng)畫(huà)，lastState讓你知道”下拉刷新”、”松手立即刷新”兩個(gè)狀態(tài)的切換。

onReleaseToRefresh和onStartPull是一樣的。

使用自定義的上拉加載尾部

這個(gè)其實(shí)和自定義的下拉刷新頭部是一樣樣的，

PullToLoadRecyclerView.setLoadViewCreator(LoadFooterCreator loadViewCreator);//使用自定義的上拉加載尾部

來(lái)看看這個(gè)LoadFooterCreator：

/**
* 上拉
* @param distance 距離
* @return 是否繼續(xù)上拉
*/
protected abstract boolean onStartPull(float distance,int lastState);
/**
* 松手加載
* @param distance 距離
* @return 是否繼續(xù)上拉
*/
protected abstract boolean onReleaseToLoad(float distance,int lastState);
/**開(kāi)始加載*/
protected abstract void onStartLoading();
/**加載結(jié)束*/
protected abstract void onStopLoad();

哦，和RefreshHeaderCreator一毛一樣，那就不說(shuō)了。

使用自定義的自動(dòng)加載尾部

還是一樣:

AutoLoadRecyclerView.setAutoLoadViewCreator(AutoLoadFooterCreator autoLoadFooterCreator);//使用自定義的自動(dòng)加載尾部

看看AutoLoadFooterCreator：

/***
* 獲得footer
*/
protected abstract View getLoadView(Context context, RecyclerView recyclerView);
/***
* 沒(méi)有更多
*/
protected abstract View getNoMoreView(Context context,RecyclerView recyclerView);

恩，更簡(jiǎn)單了，就兩個(gè)方法，獲得加載中的尾部、沒(méi)有更多的尾部。

so easy！！

后記

在之后，我會(huì)抽時(shí)間對(duì)這個(gè)項(xiàng)目的實(shí)現(xiàn)過(guò)程進(jìn)行詳細(xì)的介紹。

源碼地址：https://github.com/whichname/WZMRecyclerView

最新評(píng)論