android 上拉刷新下拉加载更多的开源框架 XRefreshView

android 上拉刷新下拉加载更多的开源框架 XRefreshView

项目地址：[[6]]https://github.com/huxq17/XRefreshView][6]，对比了网上流行的开源项目，个人认为：

XRefreshView 扩展性高。

可自定义Footers，上拉样式，完全可以自己自定义想要的交互效果和样式

可自定义Headers 下拉样式，完全可以自己自定义想要的交互效果和样式

支持所有的控件 ，RecyclerView，listview,gridview,LinearLayout,WebView等

可控性强

性能高，没有明显的重绘

作者热情，如果遇到什么问题。第一时间找他，他会第一时间帮你解答。没有架子

快捷键

我与 XRefreshView 相遇

设置自定义样式HeadersView

设置自定义样式FooterView

下拉Headers 没有什么，下面讲讲作者提供Footer样式吧

RecyclerView与其他View（ListView GridView LinearLayout……….）设置自定义下拉上拉样式View不同之处

XRefreshView 属性

布局中注意的地方。如果你的整个列表不是全屏的。可能有title有底部导航时

鸣谢

我与 XRefreshView 相遇

其实，在android 行业大军中，能自己去实现手势控件的很少。大多数都是使用开源的项目。能写出开源项目使用的人。技术水平肯定不一般。我个人自认为达不到这样的水平去实现这么复杂的效果。去年，进了新公司。开始新的编程之路。项目前期准备，在xUtils 4群里问他们，上拉下拉使用的是那个框架。刚好作者也在，发了个链接 —— [ https://github.com/huxq17/XRefreshView ] 说：要不你去看看这个吧。我进去一看。效果正是我想要的。使用到现在一年多时间了。现在才出来说说这个项目。

这里不写demo 例子，因为作者的项目里例子已经很详情，下面讲讲要注意的地方。

例子请参考[[2]]https://github.com/huxq17/XRefreshView][2].

设置自定义样式HeadersView

上拉 自定义Headers，需要实现IHeaderCallBack接口，例如：

public interface IHeaderCallBack {
/**
* 正常状态
*/
public void onStateNormal();

/**
* 准备刷新
*/
public void onStateReady();

/**
* 正在刷新
*/
public void onStateRefreshing();

/**
* 刷新结束
*/
public void onStateFinish();

/**
* 获取headerview显示的高度与headerview高度的比例
*
* @param offset
*            移动距离和headerview高度的比例，范围是0~1，0：headerview完全没显示 1：headerview完全显示
* @param offsetY
*            headerview移动的距离
*/
public void onHeaderMove(double offset, int offsetY,int deltaY);

/**
* 设置显示上一次刷新的时间
*
* @param lastRefreshTime
*            上一次刷新的时间
*/
public void setRefreshTime(long lastRefreshTime);

/**
* 隐藏footerview
*/
public void hide();

/**
* 显示footerview
*/
public void show();

/**
* 获得headerview的高度,如果不想headerview全部被隐藏，就可以只返回一部分的高度
*
* @return
*/
public int getHeaderHeight();
}

看到上面的接口就知道自己如何处理各种下拉状态了吧。根据上面的回调方法定义我们自己的UI

设置自定义样式FooterView

上拉 自定义Footer，需要实现IFooterCallBack接口，例如：

public interface IFooterCallBack {
/**
* 当不是到达底部自动加载更多的时候，需要自己写点击事件
*
* @param xRefreshViewListener
*/
public void callWhenNotAutoLoadMore(XRefreshViewListener xRefreshViewListener);

/**
* 正常状态，例如需要点击footerview才能加载更多，主要是到达底部不自动加载更多时会被调用
*/
public void onStateReady();

/**
* 正在刷新
*/
public void onStateRefreshing();

/**
* 刷新结束 在此方法中不要调用show()方法
* @param hidefooter footerview是否被隐藏
*/
public void onStateFinish(boolean hidefooter);

/**
* 已无更多数据 在此方法中不要调用show()方法
*/
public void onStateComplete();

/**
* 设置显示或者隐藏footerview 不要在onStateFinish和onStateComplete中调用此方法
* @param show
*/
public void show(boolean show);

/**
* footerview是否显示中
*
* @return
*/
public boolean isShowing();

/**
* 获得footerview的高度
*
* @return
*/
public int getFooterHeight();
}

看到上面的接口就知道自己如何处理上拉各种状态了吧。根据上面的回调方法定义我们自己的UI

下拉Headers 没有什么，下面讲讲作者提供Footer样式吧

XRefreshContentView

XRefreshViewFooter

XRefreshContentView 是支持 当数据不满一屏时，不显示上拉的Footer

XRefreshViewFooter 不同在于，当数据不满一屏时，会显示“点击加载更多”

根据个人的项目需要去使用。

如果要自定义时，可以去参考作者的这两个类。之前我向他提过一些比较无知的问。为什么这些功能不支持在XRefreshView里直接提供。作者给出的回答是。这是两种不同的概念。XRefreshView提供的只是功能。Footer样式 只是UI展示。也许，这是开发的思维模式吧。要懂划分功能逻辑与View的分离。

RecyclerView与其他View（ListView GridView LinearLayout……….）设置自定义下拉上拉样式View不同之处

ListView GridView LinearLayout……….设置方式 使用

xrv.setCustomFooterView(new XRefreshViewFooter(this));

xrv.setCustomHeaderView(new XRefreshViewHeader(this));

RecyclerView 设置

Adapter 中必须要extends BaseRecyclerAdapter

因为上拉加载完全后就不会整个列表回弹。直接显示数据。

mAdapter.setCustomLoadMoreView(view) 来设置上拉样式。

这就是RecyclerView与其他view 在设置上的不同。同时，你也可以像ListView GridView LinearLayout……….一样设置。这是没有影响了。只是上拉加载效果更多而已

XRefreshView 属性

xrv.setPullRefreshEnable(false); 是否允许刷新功能

xrv.setPullLoadEnable(false); 是否允许加载更多功能

xrv.setAutoRefresh(true); 是否自动刷新

xrv.setAutoLoadMore(true);是否滑到底部自动加载更多，false 为手动点加载更多。

xrv.setSlienceLoadMore();这个方法是设置预加载功能。预加载就是提前加载。这个只针对于上拉加载。与setPreLoadCount(5)一起用。设置5就是提示5个item 去启动去请求网络。

xrv.setPreLoadCount(5)；设置预加载提前数量。以item 为准

xrv.xrefreshView.setMoveForHorizontal(true)；这个很通用，是用来处理手势冲突的方法。比如你的列表加有横向滑动的事件，记得设置一下这个属性。让你少了很多烦恼。

布局中注意的地方。如果你的整个列表不是全屏的。可能有title有底部导航时

注意加上声明

app:isHeightMatchParent=”false”

app:isWidthMatchParent=”false”

<com.andview.refreshview.XRefreshView
android:id="@+id/xrefreshview_View"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:isHeightMatchParent="false"
app:isWidthMatchParent="false">

<android.support.v7.widget.RecyclerView
android:id="@+id/listView"
android:layout_width="match_parent"
android:layout_height="match_parent"
/>
</com.andview.refreshview.XRefreshView>

鸣谢

感谢作者。作者网名“无板替补” ＱＱ我就不方便直接写出来了。不过可以去[[6]]https://github.com/huxq17/XRefreshView][6]中有他的联系方式。如果在使用中遇到什么问题，可以直接联系他。作者挺可爱的。也很热心。

QQ群：537610843 (加群备注：XRefreshView)