XRecyclerView--仿ListView实现下拉刷新和上拉加载

XRecyclerView

介绍

XRecyclerView：对 Recyclerview 进行了扩展，仿照 ListView 实现了 RecyclerView 下拉刷新和上拉加载更多操作。效果如下：

项目地址 ，欢迎大家使用，喜欢的话star一下

鸣谢

RecyclerView 添加头部和尾部布局：本项目的原理就是来源这里

AnimRefreshRecyclerView：该控件的实现原理也是同上，其含有动画

BeautifulRefreshLayout：里面包含了坐着收集的一些下拉刷新的控件

使用方法

在build.gradle中添加：

compile'com.dalu9527:xrecyclerview:0.0.1'

在布局中使用：

RecyclerView 的其他属性不做任何修改

在 Activity or Fragment 中使用：

基本操作

private XRecyclerView mXRecyclerView;

// $ 等价于 findViewById，使用时请使用原来的 findViewById

 mXRecyclerView = (XRecyclerView)$(R.id.xr_test);
// 请勿使用系统本身的 LayoutManager ，而是需要使用以下三种 LayoutManager
XLinearLayoutManager xLinearLayoutManager = new XLinearLayoutManager(this);
// XGridLayoutManager xGridLayoutManager = new XGridLayoutManager(this,2);
// XStaggeredGridLayoutManager xStaggeredGridLayoutManager =
     new XStaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL);
mXRecyclerView.setLayoutManager(xLinearLayoutManager);
// 添加下拉刷新的头部 和 加载更多的底部，如果不加，默认含有下拉刷新的头部，而没有加载更多的底部
mHeaderView = LayoutInflater.from(this).inflate(R.layout.custom_header_view, null);
mFooterView = LayoutInflater.from(this).inflate(R.layout.footer_view, null);

mXRecyclerView.addHeaderView(mHeaderView, 50);
mXRecyclerView.addFootView(mFooterView, 50);
// 设置adapter
 mMyAdapter = new MyAdapter(mLists);

mXRecyclerView.setAdapter(mMyAdapter);
// 添加下拉刷新    
mXRecyclerView.setOnRefreshListener(new OnRefreshListener() {
        @Override
        public void onRefresh() {
            refreshData();
        }
});
// 加载更多（如果没有添加加载更多的布局，下面那LoadMore不会执行）
mXRecyclerView.setOnLoadMoreListener(new OnLoadMoreListener() {
        @Override
        public void onLoadMore() {
            loadMoreData();
        }
});
// mXRecyclerView.setEnableRefreshAndLoadMore(false);
// mXRecyclerView.setRefresh(false);

 @Override
protected void onDestroy() {
    super.onDestroy();
    mXRecyclerView.destroyHandler();
}

详细说明

1. LayoutManager 勿使用系统自身的，下面说明其对应的关系

   1. XLinearLayoutManager --> LinearLayoutManager
   2. XGridLayoutManager --> GridLayoutManager
   3. XStaggeredGridLayoutManager --> StaggeredGridLayoutManager

2. 如果不使用 mXRecyclerView.addHeaderView() 方法，会有一个默认的下拉刷新布局

3. mXRecyclerView.addHeaderView(View view, int viewHeight)，对应的参数分别表示为 下拉刷新头部 view 和 view 的高度（必须指定高度），这个方法会默认下拉刷新的最大距离为 2 倍的 viewHeight

4. mXRecyclerView.addHeaderView(View view, int viewHeight, int expandHeight)，这个方法多了一个参数， expandHeight 表示下拉刷新的滑动距离，最终的滑动距离 为 expandHeight + viewHeight

5. 如果不使用 mXRecyclerView.addFootView() 方法，则不存在加载更多操作

6. mXRecyclerView.addFootView(View view, int footerHeight)，对应的方法参数表示为 上拉加载更多的 view 和 view 的高度（必须指定高度），这个方法默认是滑倒底部就会自动加载

7. mXRecyclerView.addFootView(View view, int footerHeight, boolean isManual)，这个方法多了一个参数， isManual 表示是否手动上拉加载触发加载更多数据， false 表示 自动触发， true 表示 手动触发，上一个方法默认是 false

8. setOnRefreshListener 必须声明，否则也就达不到下拉刷新的操作了

9. setOnLoadMoreListener 可有可无，如果没有使用 addFootView 方法，则不用声明

10. mXRecyclerView.setEnableRefreshAndLoadMore(boolean) 表示是否开启下拉刷新和加载更多操作，false 表示 不开启， true 表示开启，默认是 true

11. mXRecyclerView.setRefresh(boolean) 表示是否开启下拉刷新，主要用于第一次加载数据时，自动触发下拉刷新操作， false 表示 第一次加载数据不会触发下拉刷新， true 表示 会下拉刷新，默认是 false

12. mXRecyclerView.destroyHandler() 该方法最好在 onDestroy() 中调用