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

阅读 4168
收藏 124
2016-06-20
原文链接:www.jianshu.com

介绍

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() 中调用
评论