XRecyclerView

介紹

XRecyclerView：對(duì) Recyclerview 進(jìn)行了擴(kuò)展，仿照 ListView 實(shí)現(xiàn)了 RecyclerView 下拉刷新和上拉加載更多操作。效果如下：

項(xiàng)目地址 ，歡迎大家使用，喜歡的話star一下

鳴謝

RecyclerView 添加頭部和尾部布局：本項(xiàng)目的原理就是來源這里

AnimRefreshRecyclerView：該控件的實(shí)現(xiàn)原理也是同上，其含有動(dòng)畫

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;

// $ 等價(jià)于 findViewById，使用時(shí)請(qǐng)使用原來的 findViewById

 mXRecyclerView = (XRecyclerView)$(R.id.xr_test);
// 請(qǐng)勿使用系統(tǒng)本身的 LayoutManager ，而是需要使用以下三種 LayoutManager
XLinearLayoutManager xLinearLayoutManager = new XLinearLayoutManager(this);
// XGridLayoutManager xGridLayoutManager = new XGridLayoutManager(this,2);
// XStaggeredGridLayoutManager xStaggeredGridLayoutManager =
     new XStaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL);
mXRecyclerView.setLayoutManager(xLinearLayoutManager);
// 添加下拉刷新的頭部 和 加載更多的底部，如果不加，默認(rèn)含有下拉刷新的頭部，而沒有加載更多的底部
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);
// 設(shè)置adapter
 mMyAdapter = new MyAdapter(mLists);

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

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

詳細(xì)說明

1. LayoutManager 勿使用系統(tǒng)自身的，下面說明其對(duì)應(yīng)的關(guān)系

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

2. 如果不使用 mXRecyclerView.addHeaderView() 方法，會(huì)有一個(gè)默認(rèn)的下拉刷新布局

3. mXRecyclerView.addHeaderView(View view, int viewHeight)，對(duì)應(yīng)的參數(shù)分別表示為 下拉刷新頭部 view 和 view 的高度（必須指定高度），這個(gè)方法會(huì)默認(rèn)下拉刷新的最大距離為 2 倍的 viewHeight

4. mXRecyclerView.addHeaderView(View view, int viewHeight, int expandHeight)，這個(gè)方法多了一個(gè)參數(shù)， expandHeight 表示下拉刷新的滑動(dòng)距離，最終的滑動(dòng)距離 為 expandHeight + viewHeight

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

6. mXRecyclerView.addFootView(View view, int footerHeight)，對(duì)應(yīng)的方法參數(shù)表示為 上拉加載更多的 view 和 view 的高度（必須指定高度），這個(gè)方法默認(rèn)是滑倒底部就會(huì)自動(dòng)加載

7. mXRecyclerView.addFootView(View view, int footerHeight, boolean isManual)，這個(gè)方法多了一個(gè)參數(shù)， isManual 表示是否手動(dòng)上拉加載觸發(fā)加載更多數(shù)據(jù)， false 表示 自動(dòng)觸發(fā)， true 表示 手動(dòng)觸發(fā)，上一個(gè)方法默認(rèn)是 false

8. setOnRefreshListener 必須聲明，否則也就達(dá)不到下拉刷新的操作了

9. setOnLoadMoreListener 可有可無，如果沒有使用 addFootView 方法，則不用聲明

10. mXRecyclerView.setEnableRefreshAndLoadMore(boolean) 表示是否開啟下拉刷新和加載更多操作，false 表示 不開啟， true 表示開啟，默認(rèn)是 true

11. mXRecyclerView.setRefresh(boolean) 表示是否開啟下拉刷新，主要用于第一次加載數(shù)據(jù)時(shí)，自動(dòng)觸發(fā)下拉刷新操作， false 表示 第一次加載數(shù)據(jù)不會(huì)觸發(fā)下拉刷新， true 表示 會(huì)下拉刷新，默認(rèn)是 false

12. mXRecyclerView.destroyHandler() 該方法最好在 onDestroy() 中調(diào)用