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

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

项目地址：[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 例子，因为作者的项目里例子已经很详情，下面讲讲要注意的地方。

例子请参考[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>

鸣谢

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