xrecycleview 简书_xrecyclerview-CSDN博客

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

项目地址，欢迎大家使用，喜欢的话star一下
鸣谢
RecyclerView 添加头部和尾部布局：本项目的原理就是来源这里
AnimRefreshRecyclerView：该控件的实现原理也是同上，其含有动画
BeautifulRefreshLayout：里面包含了坐着收集的一些下拉刷新的控件
使用方法
在build.gradle中添加：
compile’com.dalu9527:xrecyclerview:0.0.1’

在布局中使用：
<com.xlibs.xrv.view.XRecyclerView
android:id="@+id/xr_test"
android:layout_width=“match_parent”
android:layout_height=“match_parent”
android:overScrollMode=“never”
/>

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();
}

详细说明

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

XLinearLayoutManager --> LinearLayoutManager
XGridLayoutManager --> GridLayoutManager
XStaggeredGridLayoutManager --> StaggeredGridLayoutManager

如果不使用 mXRecyclerView.addHeaderView() 方法，会有一个默认的下拉刷新布局
mXRecyclerView.addHeaderView(View view, int viewHeight)，对应的参数分别表示为下拉刷新头部 view 和 view 的高度（必须指定高度），这个方法会默认下拉刷新的最大距离为 2 倍的 viewHeight
mXRecyclerView.addHeaderView(View view, int viewHeight, int expandHeight)，这个方法多了一个参数， expandHeight 表示下拉刷新的滑动距离，最终的滑动距离为 expandHeight + viewHeight
如果不使用 mXRecyclerView.addFootView() 方法，则不存在加载更多操作
mXRecyclerView.addFootView(View view, int footerHeight)，对应的方法参数表示为上拉加载更多的 view 和 view 的高度（必须指定高度），这个方法默认是滑倒底部就会自动加载
mXRecyclerView.addFootView(View view, int footerHeight, boolean isManual)，这个方法多了一个参数， isManual 表示是否手动上拉加载触发加载更多数据， false 表示自动触发， true 表示手动触发，上一个方法默认是 false
setOnRefreshListener 必须声明，否则也就达不到下拉刷新的操作了
setOnLoadMoreListener 可有可无，如果没有使用 addFootView 方法，则不用声明
mXRecyclerView.setEnableRefreshAndLoadMore(boolean) 表示是否开启下拉刷新和加载更多操作，false 表示不开启， true 表示开启，默认是 true
mXRecyclerView.setRefresh(boolean) 表示是否开启下拉刷新，主要用于第一次加载数据时，自动触发下拉刷新操作， false 表示第一次加载数据不会触发下拉刷新， true 表示会下拉刷新，默认是 false
mXRecyclerView.destroyHandler() 该方法最好在 onDestroy() 中调用

作者：Hello_Google
链接：https://www.jianshu.com/p/ed15eca82fd7
来源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。