一个漂亮而强大的RecyclerView

古城微笑少年丶 2022-05-12 12:44 278阅读 0赞

> 代码地址如下：  
> [http://www.demodashi.com/demo/13470.html][http_www.demodashi.com_demo_13470.html]

## 简介 ##

主要提供了简单易用强大的RecyclerView库，包括自定义刷新加载效果、极简通用的万能适配器Adapter、万能分割线、多种分组效果、常见状态页面、item动画效果、添加多个header和footer、侧滑、拖拽、Sticky（黏性）效果、多item布局等,各模块之间灵活、解耦、通用、又能相互组合使用。

## 功能 ##

*  优化RecyclerView功能
 *  支持刷新和加载更多效果，滑动到底部自动加载下页数据
 *  支持自定义刷新和加载更多效果
 *  支持添加多个header和footer，一行代码搞定
 *  支持动态加载各种Item类型的列表、网格、瀑布流
 *  支持极简通用的万能适配器Adapter，可以接受任意数据实体
 *  支持万能的分割线、设置高度（宽度）、颜色、自定义等
 *  支持点击和长按效果
 *  支持Item加载动画效果
 *  支持各种分组、随心定义分组头部、尾部、多类型内容item
 *  支持侧滑、拖拽
 *  支持Sticky（黏性）效果
 *  支持多item布局
 *  支持状态页面，加载中、空页面、错误页面、内容页面切换
 *  支持自定义万能adapter、holder

## 演示 ##

![1.gif][]  
![2.gif][]  
![3.gif][]  
![4.gif][]  
![5.gif][]  
![6.gif][]  
![7.gif][]  
![8.gif][]  
![9.gif][]  
![10.gif][]

## XRecyclerView使用介绍 ##

XRecyclerView基于RecyclerView的封装，在原有功能的基础上支持刷新、加载更多、自定义刷新加载更多、添加头部、尾部等

#### 添加(单个/多个)HeaderViw、FooterView ####

可以添加单个或者多个普通HeaderViw、FooterView,支持内容为LinearLayoutManager和GridLayoutManager。  
**方式一：**

//添加一个头部view
    mRecyclerView.addHeaderView(new SampleHeader(this));
    //mRecyclerView.addHeaderView(new SampleHeader2(this));//添加第二个头部view
    ....
    //mRecyclerView.addHeaderView(new SampleHeaderN(this));//添加第n个头部view（多头部）
    
    //添加一个尾部view
    mRecyclerView.addFooterView(new SampleFooter(this));
    //mRecyclerView.addFooterView(new SampleFooter2(this));//添加第二个尾部view
    ....
    //mRecyclerView.addFooterView(new SampleFooterN(this));//添加第n个尾部view（多尾部）

**方式二：**

//添加一个头部view
    View headerView =   LayoutInflater.from(this).inflate(R.layout.layout_header, (ViewGroup)findViewById(android.R.id.content),false);
    mRecyclerView.addHeaderView(headerView);
    //mRecyclerView.addHeaderView(headerView2);//添加第二个头部view
    ...
    //mRecyclerView.addHeaderView(headerViewN);//添加第n个头部view（多头部）
    //点击事件
    headerView.findViewById(R.id.test_txt).setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            ...
        }
    });
    
    //添加一个尾部view
    View footerView = getLayoutInflater().inflate(R.layout.layout_footer, (ViewGroup) mRecyclerView.getParent(), false);
    mRecyclerView.addFooterView(footerView);
    //mRecyclerView.addFooterView(footerView2);//添加第二个尾部view
    ....
    //mRecyclerView.addFooterView(footerViewN);//添加第n个尾部view（多尾部）
    
    //点击事件
    footerView.findViewById(R.id.test_txt).setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            ...
        }
    });

*注：此功能只是添加普通的头部和尾部，与刷新和加载更多的头部和尾部是不一样的，切记！不会影响刷新头和加载更多尾部的显示问题*

#### 移除HeaderViw、FooterView ####

//移除添加的头部view
    mRecyclerView.removeHeaderView(headerView);
    //移除添加的尾部view
    mRecyclerView.removeFooterView(footerView);

#### 下拉刷新和加载更多样式 ####

//设置下拉刷新Progress的样式
    mRecyclerView.setRefreshProgressStyle(ProgressStyle.BallSpinFadeLoader); //在ProgressStyle里面选择喜欢的样式
    //设置下拉刷新箭头
    mRecyclerView.setArrowImageView(R.drawable.iconfont_downgrey);
    //设置加载更多Progress的样式
    mRecyclerView.setLoadingMoreProgressStyle(ProgressStyle.BallPulse);

*注：1.如果采用自定义下拉刷新setRefreshHeader()和加载更多setLoadingMoreFoote()，以上设置会不起作用，也无须设置。*

#### 开启和禁止下拉刷新、加载更多功能 ####

//打开刷新和加载更多
    mRecyclerView.setPullRefreshEnabled(true);
    mRecyclerView.setLoadingMoreEnabled(true);

*注：默认是开启。*

#### 设置底部加载文字提示 ####

mRecyclerView.setFootViewText("拼命加载中","已经全部");

*注：自定义加载更多View时，此设置不起作用，切记！*

#### 下拉刷新完成 ####

mRecyclerView.refreshComplete();

#### 上拉加载更多完成 ####

mRecyclerView.loadMoreComplete();

#### 数据加载完成 ####

mRecyclerView.setNoMore(true);

#### 开启进入页面自动刷新 ####

mRecyclerView.setRefreshing(true);//没有更多数据

例：在Acitvity中开启进入页面自动刷新，在onStart()中处理。

@Override
    protected void onStart() {
        super.onStart();
        if(mRecyclerView !=null){
            mRecyclerView.setRefreshing(true);
        }
    }

#### 自定义下拉刷新View ####

1.  自定义view继承BaseRefreshHeader；
2.  调用setRefreshHeader(IRefreshHeader refreshHeader)即可。

mRecyclerView.setRefreshHeader(new CustomRefreshHeader(this));

示例：

public class CustomRefreshHeader extends BaseRefreshHeader {
        private CustomAnimView mCustomAnimView;
        public CustomRefreshHeader2(Context context) {
            super(context);
        }
    
        public CustomRefreshHeader2(Context context, AttributeSet attrs) {
            super(context, attrs);
        }
    
        @Override
        public View getView() {
            //方式一  
            mCustomAnimView = new CustomAnimView(getContext());
            return  mCustomAnimView;
            //方式二
            //return LayoutInflater.from(getContext()).inflate(R.layout.clife_loading_header,null);
        }
        
        //根据状态改变View
        @Override
        public void setState(int state) {
            super.setState(state);
            //选择自定义需要处理的状态：STATE_NORMAL、STATE_RELEASE_TO_REFRESH、STATE_REFRESHING、STATE_DONE
            //以下是我自定义动画需要用到的状态判断，你可以根据自己需求选择。
            if (state == STATE_REFRESHING) {    // 显示进度
                //这里处理自己的逻辑、刷新中
                mCustomAnimView.startAnim();
            } else if (state == STATE_DONE) {
                //这里处理自己的逻辑、刷新完成
                mCustomAnimView.stopAnim();
            } else {
                mCustomAnimView.startAnim();
            }
        }
        
    
       /* @Override
        public void refreshComplete() {
            //有默认处理、可以覆盖该方法处理，刷新完成的动作
        }*/
    
        /*@Override
        public void smoothScrollTo(int destHeight) {
            //super.smoothScrollTo(destHeight);
            //有默认处理、可以覆盖该方法处理，顺滑改变高度
        }*/
        
        //更多方法，可以通过覆写实现，自定义
    }

*注：如果设置了自定义下拉刷新，setRefreshProgressStyle（）会不起作用，无需配置，要么采用库里默认支持的样式设置，要么采用自定义View。*

#### 自定义加载更多View ####

1.  自定义view实现BaseMoreFooter接口；
2.  调用setLoadingMoreFooter(IMoreFooter refreshHeader)即可。

mRecyclerView.setLoadingMoreFooter(new CustomMoreFooter(this));

示例：

public class CustomMoreFooter extends BaseMoreFooter {
        private AnimationDrawable mAnimationDrawable;
        private LinearLayout allLayout;
        private TextView mTextView;
    
        public CustomMoreFooter(Context context) {
            super(context);
        }
    
        public CustomMoreFooter(Context context, AttributeSet attrs) {
            super(context, attrs);
        }
    
        @Override
        protected void initView() {
            super.initView();//有居中显示功能，如果不需要就去掉super.initView();
            allLayout = (LinearLayout) LayoutInflater.from(getContext()).inflate(R.layout.pull_to_refresh_clife, null);
            ImageView imageView = (ImageView) allLayout.findViewById(R.id.lodimg);
            imageView.setImageResource(R.drawable.icon_loading_animation);
            mAnimationDrawable = (AnimationDrawable) imageView.getDrawable();
            mTextView = (TextView) allLayout.findViewById(R.id.lodtext);
            addView(allLayout);
        }
    
        @Override
        public void setState(int state) {
            super.setState(state);
            //以下是我自定义动画需要用到的状态判断，你可以根据自己需求选择。
            //选择自定义需要处理的状态：STATE_LOADING、STATE_COMPLETE、STATE_NOMORE、STATE_NOMORE
            switch (state) {
                case STATE_LOADING:
                    this.setVisibility(View.VISIBLE);
                    mAnimationDrawable.start();
                    mTextView.setText("努力加载中...");
                    mTextView.setVisibility(VISIBLE);
                    break;
                case STATE_COMPLETE:
                    this.setVisibility(View.GONE);
                    mAnimationDrawable.stop();
                    mTextView.setText("加载完成");
                    break;
                case STATE_NOMORE:
                    mAnimationDrawable.stop();
                    mTextView.setText("没有更多");
                    this.setVisibility(View.GONE);
                    break;
            }
        }
    }

*注：如果设置了自定义下拉刷新，setRefreshProgressStyle（）会不起作用，无需配置，要么采用库里默认支持的样式设置，要么采用自定义View。*

#### 滑动和加载更多事件监听 ####

mRecyclerView.setLoadingListener(new XRecyclerView.LoadingListener() {
        @Override
        public void onRefresh() {
            //下拉刷新
            ...
        }
    
        @Override
        public void onLoadMore() {
            //加载更多
            ...
        }
    });

#### 设置分割线 ####

分割线可以采用库中提供的自定义万能分割线HorizontalDividerItemDecoration和XHorizontalDividerItemDecoration，这里只做使用介绍，详细请看demo中关于分割线的示例。

//例1
    recyclerView.addItemDecoration(new HorizontalDividerItemDecoration.Builder(this).build());
    //例2
    recyclerView.addItemDecoration(new HorizontalDividerItemDecoration.Builder(this)
            .paint(paint)
            .margin(15)
            .showLastDivider()
            .build());
    //例3 
    recyclerView.addItemDecoration(new com.zhouyou.recyclerview.divider.HorizontalDividerItemDecoration.Builder(this)
            //.drawable(R.drawable.divider_sample)//.9图
            .drawable(R.drawable.divider_shape)//shape文件
            .size(10)
            .build());
    //例4
    Paint paint = new Paint();
            paint.setStrokeWidth(5);
            paint.setColor(Color.BLUE);
            paint.setAntiAlias(true);
            paint.setPathEffect(new DashPathEffect(new float[]{15.0f, 15.0f}, 0));
    recyclerView.addItemDecoration(new HorizontalDividerItemDecoration.Builder(this)
                    .paint(paint)
                    .margin(15)
                    .startSkipCount(2)
                    .endSkipCount(2)
                    .build());
    .....
    //更多请看分割线讲解

*注：此分割线主要是针对LinearLayoutManager使用,对GridLayoutManager和StaggeredGridAdapter支持性比较差，针对这一类的分割线还需要自定义实现。*

#### 设置侧滑菜单 ####

设置侧滑菜单需要用到自定义SwipeMenuRecyclerView，此view是继承自XRecyclerView，具备XRecyclerView的所有功能和属性。  
1.Xml布局引用SwipeMenuRecyclerView

<com.zhouyou.recyclerview.swipemenu.SwipeMenuRecyclerView
            android:id="@+id/super_swipemenu_recycle_view"
            android:layout_width="match_parent"
            android:layout_height="match_parent" />

2.侧滑菜单对适配器没有特殊要求可以继承任意Adapter，但是对item的布局文件有要求，需要用SwipeMenuLayout。  
例如：adapter\_menu\_layout\_item.xml

<?xml version="1.0" encoding="utf-8"?>
    
    <com.zhouyou.recyclerview.swipemenu.SwipeMenuLayout xmlns:android="http://schemas.android.com/apk/res/android"
                                                        android:layout_width="match_parent"
                                                        android:layout_height="wrap_content">
        
        <include
            android:id="@+id/smContentView"
            layout="@layout/item_swipe_menu_content" />
        
        <include
            android:id="@+id/smMenuView"
            layout="@layout/item_swipe_menu1" />
    
    </com.zhouyou.recyclerview.swipemenu.SwipeMenuLayout>

*注：其它关于SwipeMenuLayout更多使用方法，请参考demo示例。*

#### 设置sticky悬停 ####

主要提供了两种悬停效果：一种是*鸿洋大神*的StickyNavLayout，另一种是用StickyNestedScrollView（继承自V4包NestedScrollView进行扩展）。为什么会把这两种悬停效果放到库中处理呢，因为XRecyclerView、StickyNavLayout/StickyNestedScrollView、Tablayout、ViewPager、HelperRecyclerViewAdapter等相互组合使用会存在冲突等问题，本库中都已经解决了存在的已知兼容问题，互相打通，另一方面也是收集常用功能对EasyXRecyclerView的完善。  
**StickyNavLayout使用介绍：**

可以设置页面某个控件滑动悬停，底部内容区域支持 ScrollView ，ListView,RecyclerView。  
注意控件id的设置

*  top区域:id必须为 android:id="@+id/id\_stickynavlayout\_topview"
 *  悬浮区域:id必须为android:id="@+id/id\_stickynavlayout\_indicator"
 *  内容区域:id必须为android:id="@+id/id\_stickynavlayout\_viewpager"

内容区域

*  此方式内容区域必须需为ViewPager或者其子类
 *  ViewPager的内容可以是Fragment,如果Fragment里面是ListView,RecycleView等需要设置其id为:android:id="@+id/id\_stickynavlayout\_innerscrollview"

在xml中引入：

<?xml version="1.0" encoding="utf-8"?>
    <com.zhouyou.recyclerview.sticky.StickyNavLayout
        android:id="@+id/id_stick"
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        app:isStickNav="false">
        
        <LinearLayout
            android:id="@id/id_stickynavlayout_topview"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="vertical">
            
            ...
        </LinearLayout>
    
        
        <LinearLayout
            android:id="@id/id_stickynavlayout_indicator"
              ...
            >
            
            ...
        </LinearLayout>
        
        
        <android.support.v4.view.ViewPager
            android:id="@id/id_stickynavlayout_viewpager"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            />
    </com.zhouyou.recyclerview.sticky.StickyNavLayout>

*注：更多使用功能请参考[鸿洋大神][Link 1]的讲解。*  
**StickyNestedScrollView使用介绍：**

StickyNestedScrollView方式使用比较简单，可以支持设置多个悬停。只需要在需要悬停的控件上设置tag属性，tag属性可以设置为：sticky、sticky-nonconstant、sticky-hastransparency，一般直接使用`android:tag="sticky"`。  
在xml中引入:

<?xml version="1.0" encoding="utf-8"?>
    <android.support.design.widget.CoordinatorLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:fitsSystemWindows="true">
        <com.zhouyou.recyclerview.sticky.StickyNestedScrollView
            android:id="@+id/scroll_view"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            app:layout_behavior="@string/appbar_scrolling_view_behavior">
    
            <LinearLayout
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:orientation="vertical">
    
                
                <TextView
                     ...
                    android:tag="sticky"
                    android:text="A"/>
                
                <TextView
                ...
                android:text="B"/>
                
                <TextView
                ...
                android:tag="sticky"
                android:text="B"/>
    
            </LinearLayout>
        </com.zhouyou.recyclerview.sticky.StickyNestedScrollView>
    </android.support.design.widget.CoordinatorLayout>

StickyNestedScrollView支持的方法`addOnViewStickyListener(OnViewStickyListener stickyListener)、removeOnViewStickyListener(OnViewStickyListener stickyListener)、clearOnViewStickyListener()、setShadowHeight(int height)、setShadowDrawable(Drawable shadowDrawable)`。如果XRecyclerview适配器中的某个item需要悬停，只需要将item布局设置`android:tag="sticky"`即可实现item悬停，但是这样会有一个问题，如果在xml中静态设置所有的item都会有悬停，可以在设配器中获取到item布局对象根据业务逻辑进行动态设置`view.setTag("sticky");`

**StickyNavLayout与StickyNestedScrollView对比**

1.  StickyNavLayout使用起来相对于StickyNestedScrollView比较麻烦，特别是要注意Id的设置，StickyNestedScrollView使用更加便捷一些。
2.  StickyNavLayout支持单个悬停，StickyNestedScrollView支持多个悬停。
3.  StickyNestedScrollView不适合与带有刷新和加载更多的Recyclerview嵌套，嵌套后Recyclerview的加载更多会失效，而StickyNavLayout不会影响加载跟多功能。
4.  如果内容比较多建议采用StickyNavLayout+Recyclerview来实现分页带有头部的列表悬停功能，StickyNestedScrollView+Recyclerview不能装载太多的数据特别是用于分页。因为StickyNestedScrollView原理是把Recyclerview的滑动事件都转移给自己来处理，这样Recyclerview的复用机制就会不起作用，数据过多容易OOM.单页面且数据量不多可以采用StickyNestedScrollView更简单。

*注：其它更多复杂的悬停使用场景请参考demo中关于Sticky部分的示例。*

#### 完整示例 ####

所有的属性设置，都是根据自己的需要进行设置，不需要把所有属性都设置一遍，切记！切记！切记！

XRecyclerView mRecyclerView = (com.zhouyou.recyclerview.XRecyclerView) this.findViewById(R.id.recyclerview);
    LinearLayoutManager layoutManager = new LinearLayoutManager(this);
    layoutManager.setAutoMeasureEnabled(true);
    layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
    mRecyclerView.setLayoutManager(layoutManager);
    
    //刷新方式二选一：方式一or方式二 
    //方式一：采用库中提供的默认刷新样式
    mRecyclerView.setRefreshProgressStyle(ProgressStyle.BallSpinFadeLoader); //设置下拉刷新Progress的样式,在ProgressStyle里面选择喜欢的样式
    mRecyclerView.setArrowImageView(R.drawable.iconfont_downgrey);//设置下拉刷新箭头
    mRecyclerView.setLoadingMoreProgressStyle(ProgressStyle.BallPulse);  //设置加载更多Progress的样式
    mRecyclerView.setFootViewText("拼命加载中","已经全部");
    
    //方式二：完全采用自定义的刷新动画
    //mRecyclerView.setRefreshHeader(new CustomRefreshHeader(this));
    //mRecyclerView.setLoadingMoreFooter(new CustomLoadingMoreFooter(this));
    
    //打开刷新和加载更多
    //mRecyclerView.setPullRefreshEnabled(true);
    //mRecyclerView.setLoadingMoreEnabled(true);
    
    //添加一个头部view和尾部view
    View headerView =   LayoutInflater.from(this).inflate(R.layout.layout_header, (ViewGroup)findViewById(android.R.id.content),false);
    View footerView = getLayoutInflater().inflate(R.layout.layout_footer, (ViewGroup) mRecyclerView.getParent(), false);
    mRecyclerView.addHeaderView(headerView);
    mRecyclerView.addFooterView(footerView);
    
    //分割线设置
    mRecyclerView.addItemDecoration(new HorizontalDividerItemDecoration.Builder(this).build());
    
    //移除添加的头部view
    mRecyclerView.removeHeaderView(headerView);
    //移除添加的尾部view
    mRecyclerView.removeFooterView(footerView);
    mRecyclerView.setLoadingListener(new XRecyclerView.LoadingListener() {
        @Override
        public void onRefresh() {
            //下拉刷新
            //mRecyclerView.refreshComplete();//刷新动画完成
        }
    
        @Override
        public void onLoadMore() {
            //加载更多
            //mRecyclerView.loadMoreComplete();//加载动画完成
            //mRecyclerView.setNoMore(true);//数据加载完成
        }
    });
    
    //装载数据
    MyAdapter mAdapter = new MyAdapter(this);
    mRecyclerView.setAdapter(mAdapter);//本库不成文规定，最好使用setAdapter写在装载数据之前
    mAdapter.setListAll(datas);//该动作放在setAdapter之后

### [github源码地址：https://github.com/zhou-you/EasyXRecyclerView][github_https_github.com_zhou-you_EasyXRecyclerView] ###

\#\#万能适配器Adapter功能介绍  
RecyclerView适配器的传统使用方法是继承`RecyclerView.Adapter<RecyclerView.ViewHolder>`相信大家都很清楚（不清楚的请先自行学习官方使用方式），这里为什么提供一种万能适配器呢？主要是方便快捷的开发，一种最佳偷懒姿势，打造属于RecyclerView的万能适配器Adapter和ViewHolder、以及更简单方便的数据绑定和操作。

#### 特性 ####

*  优化了Adapter代码，减少了代码量
 *  简单配置、无需重写额外方法
 *  添加Item事件
 *   *  Item的点击事件
 *   *  Item的长按事件
 *  添加列表加载动画
 *   *  一行代码轻松切换5种默认动画
 *  支持添加分组
 *   *  随心定义分组头部、尾部
 *   *  支持点击展开收起
 *   *  支持配置是否带组头或组尾（组头、组尾是否显示）
 *   *  子项为Grid（并支持Span不同）
 *   *  头、尾、子项支持多种类型
 *   *  支持分组带有Sticky黏性效果
 *   *  分组增加状态页面占位显示（加载中、错误页面、空页面、内容页面）
 *  自定义不同的item类型
 *  支持添加item拖拽
 *  支持自定义ViewHolder，让开发者随心所欲

#### 主要相关类介绍 ####

<table> 
 <thead> 
  <tr> 
   <th>类名</th> 
   <th>功能</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>BaseRecyclerViewAdapter</td> 
   <td>万能适配器基类</td> 
   <td>继承该类该就可体验极简适配器用法、也可继承该类扩展功能。</td> 
  </tr> 
  <tr> 
   <td><strong>HelperRecyclerViewAdapter</strong></td> 
   <td>提供便捷数据操作的万能适配器，继承BaseRecyclerViewAdapter</td> 
   <td>此类在万能适配的基础上增加了数据操作，可以直接继承该类实现适配器 （<em>推荐用法</em>）。</td> 
  </tr> 
  <tr> 
   <td>HelperRecyclerViewAnimAdapter</td> 
   <td>提供带有动画效果的万能适配器，继承HelperRecyclerViewAdapter</td> 
   <td>如果不需要动画效果，请直接使用HelperRecyclerViewAdapter。</td> 
  </tr> 
  <tr> 
   <td>HelpRecyclerViewDragAdapter</td> 
   <td>提供带有拖拽效果的万能适配器，继承HelperRecyclerViewAdapter</td> 
   <td>如果不需要拖拽效果，请直接使用HelperRecyclerViewAdapter。</td> 
  </tr> 
  <tr> 
   <td>HelperStateRecyclerViewAdapter</td> 
   <td>提供带有状态页面的万能适配器，继承HelperRecyclerViewAdapter</td> 
   <td>继承该类该就可配置页面加载中、错误、空页面、内容页面之间自由切换。</td> 
  </tr> 
  <tr> 
   <td>GroupedRecyclerViewAdapter</td> 
   <td>分组适配器</td> 
   <td>继承该类该可实现各种分组效果 。</td> 
  </tr> 
  <tr> 
   <td>GroupedStateRecyclerViewAdapter</td> 
   <td>具有分组和支持状态页面切换的适配器，继承GroupedRecyclerViewAdapter</td> 
   <td>如果不需要状态页面，请直接使用GroupedRecyclerViewAdapter。</td> 
  </tr> 
  <tr> 
   <td>BaseRecyclerViewHolder</td> 
   <td>万能适配Holder</td> 
   <td>可继承该类扩展功能。</td> 
  </tr> 
  <tr> 
   <td><strong>HelperRecyclerViewHolder</strong></td> 
   <td>具有view快捷操作的Holder，继承BaseRecyclerViewHolder</td> 
   <td>此类在BaseRecyclerViewHolder基础上增加了view绑定的便捷操作（<em>推荐用法</em>）。</td> 
  </tr> 
 </tbody> 
</table>

*注：  
1.主要推荐用法是 **HelperRecyclerViewAdapter**\+**HelperRecyclerViewHolder**完美打造万能适配器，其它可根据具体需求自由选择适配器。  
2.类名HelpXXX开头和GroupedXXX相关的类用方法差别较大，请看提供的具体demo用法  
3.使用适配器时在Activity和Fragment等中不需要再创建一个集合用于存放数据，适配器里面已经默认内置装载数据的集合`List<T>`，否则会有两个集合占用内存,从**网络**返回的数据是集合可以直接丢进适配器里面。*

#### HelperRecyclerViewAdapter支持的数据操作接口介绍 ####

HelperRecyclerViewAdapter是继承于BaseRecyclerViewAdapter同时实现了DataHelper数据操作接口，在使用中会更加简单快捷，具体如下：

<table> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>void add(int position, T data);</strong></td> 
   <td>添加单个数据data到指定位置position</td> 
  </tr> 
  <tr> 
   <td>addAll(int startPosition, List datas)</td> 
   <td>添加数据集合datas到指定位置position</td> 
  </tr> 
  <tr> 
   <td>addItemToHead(T data)</td> 
   <td>添加单个数据data到列表头部</td> 
  </tr> 
  <tr> 
   <td>addItemsToHead(List datas)</td> 
   <td>添加数据集datas到列表头部</td> 
  </tr> 
  <tr> 
   <td>addItemToLast(T data)</td> 
   <td>添加单个数据data到列表尾部</td> 
  </tr> 
  <tr> 
   <td>addItemsToLast(List datas)</td> 
   <td>添加数据集合datas到列表尾部</td> 
  </tr> 
  <tr> 
   <td>alterObj(T oldData, T newData)</td> 
   <td>将集合中的数据oldDagta修改成新数据newData</td> 
  </tr> 
  <tr> 
   <td>alterObj(int index, T data)</td> 
   <td>将index位置的数据修改成data</td> 
  </tr> 
  <tr> 
   <td>** clear()**</td> 
   <td>情空所有数据</td> 
  </tr> 
  <tr> 
   <td>** contains(T data)**</td> 
   <td>判断集合中是否包含数据data</td> 
  </tr> 
  <tr> 
   <td>** getData(int index)**</td> 
   <td>获取index位置的数据，return T</td> 
  </tr> 
  <tr> 
   <td>isEnabled(int position)</td> 
   <td>判断position位置是否有效</td> 
  </tr> 
  <tr> 
   <td>remove(T data)</td> 
   <td>移除集合中的数据data</td> 
  </tr> 
  <tr> 
   <td>removeToIndex(int index)</td> 
   <td>移除结合中index位置的数据</td> 
  </tr> 
  <tr> 
   <td>removeToIndex(int index)</td> 
   <td>移除结合中index位置的数据</td> 
  </tr> 
  <tr> 
   <td>replaceAll(List datas)</td> 
   <td>替换适配器集合中所有的数据</td> 
  </tr> 
  <tr> 
   <td><strong>setListAll(List datas)</strong></td> 
   <td>覆盖所有数据</td> 
  </tr> 
 </tbody> 
</table>

*注：  
1.需要先调用`setListAll(List<T> datas)`或者从适配器构造方法里装载数据后，再允许操作其它方法。  
2.使用以上提供的方法，里面都有做空指针和索引越界判断，外部不管集合或者数据data是否为null都可传递.不会导致应用崩溃。  
3.使用以上所有方法有不用再调用`notifyDataSetChanged()`方法刷新适配器了，方法里面会自动帮你触发刷新通知。*

#### 万能适配器使用介绍 ####

/**
     * <p>描述：自定义适配器（请大家重点参考此类的使用方式和讲解）</p>
     * 
     * 一下代码会提供四种设置数据的构造<br/>
     * 本代码模拟采用方式四来举例，其实也是方式二的一个变种，大部分适配器都是对应一个item布局。<br/>
     * 传统的写法请参考：OldMyAdapter.java<br/>
     * 作者： zhouyou<br>
     * 日期： 2016/10/27 16:24<br>
     * 版本： v2.0<br>
     */
    public class MyAdapter extends HelperRecyclerViewAdapter<TestBean> {
        //以下提供适配器的几种构造使用方式，请选择自己喜欢的【一种】运用方式就可以了
        /*
        //方式一 data layoutId都从外部传入，例如：new MyAdapter(mList,this,R.layout.item)
        //注意layoutIds是表示可变参数，支持传入多个布局，用于支持多item布局，例如：new MyAdapter(mList,this,R.layout.item，R.layout.item2)
        public MyAdapter(List<TestBean> data, Context context, int... layoutIds) {
            super(data, context, layoutIds);
        }
        //方式二 layoutIds从外部传入，例如：MyAdapter  adapter = new MyAdapter(this,R.layout.item),数据传递用adapter.setListAll(mList);
        //注意layoutIds是表示可变参数，支持传入多个布局，用于支持多item布局，例如：new MyAdapter(this,R.layout.item，R.layout.item2)
        public MyAdapter(Context context, int... layoutIds) {
            super(context, layoutIds);
        }
        
        //方式三 数据从外部传入，布局直接写在里面（推荐使用方式），好处把适配器相关的item布局都放在本来中一块管理
        public MyAdapter(List<TestBean> mList, Context context) {
            super(mList, context,R.layout.item);//单item布局
            //super(mList, context,R.layout.item,R.layout.item2);//多item布局
        }*/
    
        //方式四 布局直接通过在构造方法中设置（推荐使用方式），数据集合通过setListAll设置
        public MyAdapter(Context context) {
            super(context, R.layout.item);
        }
    
       //不需要自己再自定义viewHolder类了 库里定义有viewHolder基类HelperRecyclerViewHolder
        @Override
        protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, TestBean item) {
            /****1.数据获取方式*****/
            //旧：传统的写法是从集合中获取再强转,如下：
            //TestBean testBean =(TestBean)datas.get(position);
            //新：baseadapter中提供的有获取当前postion位置对应的数据，直接调用就行了，也不用强转
            final TestBean testBean = getData(position);
    
            /****2.view赋值*****/
            //方式一：采用链式的设计的书写方式，一点到尾。（方式一）
            viewHolder.setText(R.id.text,testBean.getName())
                    .setImageResource(R.id.image, MakePicUtil.makePic(position))
                   /* .setVisible(R.id.text,true);//设置某个view是否可见*/
            .setOnClickListener(R.id.image, new View.OnClickListener() {//点击事件
                @Override
                public void onClick(View view) {
                    Toast.makeText(mContext, "我是子控件" + testBean.getName() + "请看我如何处理View点击事件的", Toast.LENGTH_LONG).show();
                }
            });
            //其它更多连写功能请查看viewHolder类中代码
            
            //方式二：不采用链式的方式，通过getView直接获取控件对象，不需要强转了，采用的是泛型
            TextView textView =viewHolder.getView(R.id.text2);
            textView.setText(testBean.getAge());
    
            /****3.其它更多使用方式，请自己探索*****/
            //举例如果想知道适配器中数据是否为空用isEmpty()就可以了，无需list.size()==0  list.isEmpty()等其它方式
            if(isEmpty()){
                
            }
        }
    
        /*******************以下两种item点击事件都可以，自己选择合适的方式**********************************/
        //方式一：此方式是另一种处理：绑定相关事件,例如点击长按等,默认空实现，如果你要使用需要覆写setListener()方法
        //方式二：绑定相关事件,例如点击长按等,默认空实现等我们一般会在适配器外部使用，
        // 例如： mAdapter.setOnItemClickListener(new BaseRecyclerViewAdapter.OnItemClickListener<TestBean>(){});
        
       /* @Override
        protected void setListener(HelperRecyclerViewHolder viewHolder, final int position, TestBean item) {
            viewHolder.getItemView().setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View view) {
                    Toast.makeText(mContext,"我是Item："+position,Toast.LENGTH_SHORT).show();
                }
            });
        }*/
       
    }

Activity/Fragment中引用：

//用框架里面的adapter时不需要再建立全局集合存放数据了，数据都和adapter绑定了，里面自带泛型集合
    //如果你外面还建立一个集合，那相当于占用内存两份了。。
    List<TestBean> listData = new ArrayList<TestBean>();
    
    //方式四对应的初始化适配器   也可采用下面的构造方式创建对象  （自己选择）
    //这种方式一定要先setAdapter然后才setListAll（）设置数据
    mAdapter = new MyAdapter(this);
    mRecyclerView.setAdapter(mAdapter);
    
    /****讲解*****/
    //1.使用setListAll（覆盖数据）后就不需要再调用notifyDataSetChanged（）
    //2.如果是addAll()追加
    //3.自己会刷新
    //4.如果集合List<TestBean>是从网络请求中返回的，那么此处就不需要再多创建new ArrayList<TestBean>()操作，直接在网络请求你成功的地方调用mAdapter.setListAll（list）；
    mAdapter.setListAll(listData);
    
    //方式一对应的初始化适配器
    //mAdapter = new MyAdapter(listData, this, R.layout.item);
    //方式二对应的初始化适配器
    //mAdapter = new MyAdapter(this, R.layout.item);

#### 多Item布局使用介绍 ####

/**
     * <p>描述：多item适配器</p>
     *
     * 作者： zhouyou<br>
     * 日期： 2016/10/31 16:24<br>
     * 版本： v2.0<br>
     */
    public class MultiItemAdapter extends com.zhouyou.recyclerview.adapter.HelperRecyclerViewAdapter<MultipleItemBean> {
    
        public MultiItemAdapter(Context context) {
            //设置多item布局adapter_multi_item1_layout，adapter_multi_item2_layout，adapter_multi_item3_layout
            super(context, R.layout.adapter_multi_item1_layout,R.layout.adapter_multi_item2_layout,R.layout.adapter_multi_item3_layout);
        }
    
        @Override
        protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, MultipleItemBean item) {
            //方式一，对应checkLayout中的方式一
            if(item.getItemType() == 0){//adapter_multi_item1_layout布局对应的操作
                viewHolder.setText(R.id.name_tv,item.getName());
            } else if(item.getItemType() == 1){//adapter_multi_item2_layout布局对应的操作
                viewHolder.setText(R.id.name_tv,item.getName())
                        .setText(R.id.info_tv,item.getAge());
            }
    
            /*//方式二，对应checkLayout中的方式二
            int layoutType = getItemViewType(position);
            if(layoutType==R.layout.adapter_multi_item1_layout){
                viewHolder.setText(R.id.name_tv,item.getName());
            }else if(layoutType==R.layout.adapter_multi_item2_layout){
                viewHolder.setText(R.id.name_tv,item.getName())
                        .setText(R.id.info_tv,item.getAge());
            }*/
        }
    
        /*********多item布局使用方式***********/
        //如果要用多item布局，必须重写checkLayout()方法，来指定哪一条数据对应哪个item布局文件
        //不重写的时候返回默认是0，也就是只会加载第一个布局
        @Override
        public int checkLayout(MultipleItemBean item, int position) {
            //方式一：判断的类型直接写在model中
            return item.getItemType();
            //方式二：根据类型判断
            /*if(item instanceof A){
                return R.layout.adapter_multi_item1_layout;
            }else if(item instanceof B){
                return R.layout.adapter_multi_item2_layout;
            }else {
                return R.layout.adapter_multi_item3_layout;
            }*/
        }
    }

#### 添加Item事件 ####

//1.设置item事件监听
    //2.在适配器MyAdapter类中也可以设置点击事件，采用setListener()接口
    mAdapter.setOnItemClickListener(new BaseRecyclerViewAdapter.OnItemClickListener<TestBean>() {
        @Override
        public void onItemClick(View view, TestBean item, int position) {
            Toast.makeText(getApplicationContext(),"我是item "+position,Toast.LENGTH_LONG).show();
        }
    });
    
    //长按事件
    mAdapter.setOnItemLongClickListener(new BaseRecyclerViewAdapter.OnItemLongClickListener() {
        @Override
        public void onItemLongClick(View view, Object item, int position) {
            Toast.makeText(getApplicationContext(),"我是item长按 "+position,Toast.LENGTH_LONG).show();
        }
    });

#### Item拖拽使用介绍 ####

适配器需要继承HelperRecyclerViewDragAdapter,同样具备所有万能适配器的功能。

/**
     * <p>描述：item可以移动拖拽的适配器</p>
     *
     *
     * 作者： zhouyou<br>
     * 日期： 2016/10/31 16:24<br>
     * 版本： v2.0<br>
     */
    public class DragAdapter extends HelperRecyclerViewDragAdapter<String> {
        public DragAdapter(Context context) {
            super(context, R.layout.adapter_draggable_layout);
        }
    
        @Override
        protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, String item) {
            viewHolder.setText(R.id.tv,item).setImageResource(R.id.image, MakePicUtil.makePic(position));
        }
    }

Activity/Fragment中引用：

//拖动监听事件
    OnItemDragListener listener = new OnItemDragListener() {
        @Override
        public void onItemDragStart(RecyclerView.ViewHolder viewHolder, int pos) {
            //开始拖动
        }
    
        @Override
        public void onItemDragMoving(RecyclerView.ViewHolder source, int from, RecyclerView.ViewHolder target, int to) {
            //拖动中
        }
    
        @Override
        public void onItemDragEnd(RecyclerView.ViewHolder viewHolder, int pos) {
            //拖动结束
        }
    };
    
    DragAdapter mAdapter = new DragAdapter(this);
    //适配器绑定item拖动监听
    ItemDragListener mItemDragAndSwipeCallback = new ItemDragListener(mAdapter);
    //触摸帮助类
    ItemTouchHelper mItemTouchHelper = new ItemTouchHelper(mItemDragAndSwipeCallback);
    //绑定RecyclerView
    mItemTouchHelper.attachToRecyclerView(mRecyclerView);
    //设置允许拖动的方向
    mItemDragAndSwipeCallback.setDragMoveFlags(ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT | ItemTouchHelper.UP | ItemTouchHelper.DOWN);
    //设置监听
    mAdapter.enableDragItem(mItemTouchHelper);
    mAdapter.setOnItemDragListener(listener);
    
    //item点击事件
    mAdapter.setOnItemClickListener(new BaseRecyclerViewAdapter.OnItemClickListener<String>() {
        @Override
        public void onItemClick(View view, String item, int position) {
            Toast.makeText(DragActivity.this,item,Toast.LENGTH_SHORT).show();
        }
    });
    //设置适配器
    mRecyclerView.setAdapter(mAdapter);
    mAdapter.setListAll(mData);

#### Item动画使用介绍 ####

适配器需要继承HelperRecyclerViewAnimAdapter,同样具备所有万能适配器的功能。

/**
     * <p>描述：具有动画效果的适配器</p>
     *
     * 作者： zhouyou<br>
     * 日期： 2016/10/31 16:24<br>
     * 版本： v2.0<br>
     */
    public class AnimationAdapter extends HelperRecyclerViewAnimAdapter<String> {
    
        public AnimationAdapter(Context context) {
            super(context, R.layout.adapter_animation_layout);
        }
        @Override
        protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, Object item) {
            
        }
    }

Activity/Fragment中引用：

AnimationAdapter mAdapter = new AnimationAdapter(this);
    mAdapter.setShowItemAnimationEveryTime(true);//是否每次都会执行动画,默认是false,该方便测试
    mAdapter.setItemAnimation(AnimationType.ALPHA);//设置item动画类型ALPHA、SCALE、SLIDE_FROM_LEFT、SLIDE_FROM_RIGHT、SLIDE_FROM_BOTTOM
    //mAdapter.setCustomItemAnimator(new CustomAnimator());//自定义实现动画
    //mAdapter.setItemAnimationDuration(2000);//设置动画执行时间
    //mAdapter.setItemAnimationInterpolator(new AccelerateInterpolator());//设置动画插值器
    
    superRecyclerView.setAdapter(mAdapter);
    mAdapter.setListAll(dataList);//设置数据

#### 状态页面适配器介绍 ####

状态页面适配器主要是解决列表页面具有加载中页面、空页面、错误页面、内容页面之间无缝切换的问题。通常的做法是用一个普通的占位页面和Recyclerview布局平级，通过显示和隐藏等来改变占位页面达到效果。这里尝试另一种方式来解决此问题，在适配器中实现具体的getEmptyView，getErrorView，getLoadingView,虽然多了几个方法，但是代码更整洁清晰了，也利于你想定制任意的页面状态，根据调用的方法动态监控类表的数据装载情况才显示出占位图，有列表内容显示的时候占位图不会被加载不会占用内存。

/**
     * <p>描述：状态页面适配器</p>
     * 1.实现具体的getEmptyView，getErrorView，getLoadingView,虽然多了几个方法，但是代码更整洁清晰了，也利于你想定制任意的页面状态<br>
     * 2.如果你的每个页面状态都是一样的，不想每个页面都去实现getEmptyView，getErrorView，getLoadingView，可以自己再封装一个baseAdapter,处理公共的状态页面<br>
     * 作者： zhouyou<br>
     * 日期： 2018/1/19 17:51 <br>
     * 版本： v1.0<br>
     */
    public class EmptyStateAdapter extends HelperStateRecyclerViewAdapter<String> {
        public EmptyStateAdapter(List data, Context context, int... layoutId) {
            super(data, context, layoutId);
        }
    
        public EmptyStateAdapter(Context context) {
            super(context, R.layout.header_footer_item);
        }
    
        //不需要自己再自定义viewHolder类了 库里定义有viewHolder基类HelperRecyclerViewHolder
        @Override
        protected void HelperBindData(HelperRecyclerViewHolder viewHolder, int position, String item) {
            final String value = getData(position);
            viewHolder.setText(R.id.test_btn, value);
        }
    
        @Override
        public View getEmptyView(ViewGroup parent) {
            //空页面内容布局
            return mLInflater.inflate(R.layout.view_state_empty, parent, false);
        }
    
        @Override
        public View getErrorView(ViewGroup parent) {
            //错误页面布局
            return mLInflater.inflate(R.layout.view_state_error, parent, false);
        }
    
        @Override
        public View getLoadingView(ViewGroup parent) {
            //加载中页面布局
            return mLInflater.inflate(R.layout.view_state_loading, parent, false);
        }
    
        //onBindEmptyViewHolder、onBindErrorViewHolder、onBindLoadingViewHolder根据需要进行选择是否实现。
        @Override
        public void onBindEmptyViewHolder(HelperRecyclerViewHolder holder) {
            //修改空页面内容
            holder.setText(R.id.tv_empty_view, "我更新了空页面内容");
        }
    
        
       /* @Override
        public void onBindErrorViewHolder(HelperRecyclerViewHolder holder) {
            super.onBindErrorViewHolder(holder);
        }*/
    
       /* @Override
        public void onBindLoadingViewHolder(HelperRecyclerViewHolder holder) {
            super.onBindLoadingViewHolder(holder);
        }*/
    }

在需要的地方，通过一些方法来控制页面的显示。

mAdapter = new EmptyStateAdapter(this);
    mRecyclerView.setAdapter(mAdapter);
    
    //以下状态在需要的地方调用
    mAdapter.setState(HelperStateRecyclerViewAdapter.STATE_LOADING);//模拟加载中
    //mAdapter.setState(HelperStateRecyclerViewAdapter.STATE_ERROR);
    //mAdapter.setState(HelperStateRecyclerViewAdapter.STATE_EMPTY);
    //如果页面列表集合有内容调用mAdapter.setListAll(list);时会自动隐藏占位图
    mAdapter.setListAll(list);
    //如果设置了 mAdapter.setState()调用：mAdapter.clear();/mAdapter.remove()等都会自动切换到占位图
    
    
    //如果用网格Manager,必须用StateGridLayoutManager，否则Grid状态页面会不起作用
    StateGridLayoutManager layoutManager = new StateGridLayoutManager(this,3);
    //切记！切记！切记！
    //setLayoutManager方法一定要放在setAdapter之后，否则LayoutManager是GridLayoutManager的时候尾部脚显示错误
    mRecyclerView.setLayoutManager(layoutManager);

*注：  
1.如果用网格Manager,必须用StateGridLayoutManager，否则Grid状态页面会不起作用  
2.setLayoutManager方法一定要放在setAdapter之后，否则LayoutManager是GridLayoutManager的时候尾部显示错误,切记！切记！切记！*

#### 分组显示 ####

主要采用GroupedRecyclerViewAdapter可以很方便的实现RecyclerView的分组显示，并且每个组都可以包含组头、组尾和子项；可以方便实现多种Type类型的列表，可以实现如QQ联系人的列表一样的列表展开收起功能，还可以实现头部悬浮吸顶功能等。  
示例：

public class GroupedListAdapter extends GroupedRecyclerViewAdapter<GroupBean> {
        public GroupedListAdapter(Context context) {
            super(context);
        }
    
        public GroupedListAdapter(Context context, List<GroupBean> list) {
            super(context, list);
        }
    
        //返回组的数量
        @Override
        public int getGroupCount() {
            return getGroups().size();
        }
    
        //返回当前组的子项数量
        @Override
        public int getChildrenCount(int groupPosition) {
            return getGroup(groupPosition).getChildren().size();
        }
        //当前这个组是否有头部
        @Override
        public boolean hasHeader(int groupPosition) {
            return true;
        }
    
        //当前这个组是否有尾部
        @Override
        public boolean hasFooter(int groupPosition) {
            return true;
        }
    
        //返回头部的布局id。(如果hasHeader返回false，这个方法不会执行)
        @Override
        public int getHeaderLayout(int viewType) {
            return R.layout.adapter_header;
        }
    
        //返回尾部的布局id。(如果hasFooter返回false，这个方法不会执行)
        @Override
        public int getFooterLayout(int viewType) {
            return R.layout.adapter_footer;
        }
    
        //返回子项的布局id。
        @Override
        public int getChildLayout(int viewType) {
            return R.layout.adapter_child;
        }
    
        //绑定头部布局数据。(如果hasHeader返回false，这个方法不会执行)
        @Override
        public void onBindHeaderViewHolder(HelperRecyclerViewHolder holder, int groupPosition, GroupBean item) {
            //也可以通过Group获取
            //GroupEntity entity =getGroup(groupPosition);
            holder.setText(R.id.tv_header, item.getHeader());
        }
    
        //绑定尾部布局数据。(如果hasFooter返回false，这个方法不会执行)
        @Override
        public void onBindFooterViewHolder(HelperRecyclerViewHolder holder, int groupPosition, GroupBean item) {
            holder.setText(R.id.tv_footer, item.getFooter());
        }
    
        //绑定子项布局数据。
        @Override
        public void onBindChildViewHolder(HelperRecyclerViewHolder holder, int groupPosition, int childPosition, GroupBean item) {
            holder.setText(R.id.tv_child, item.getChildren().get(childPosition).getChild());
        }
    }

还可是重写GroupedRecyclerViewAdapter方法实现头、尾和子项的多种类型item。

//返回头部的viewType。
    public int getHeaderViewType(int groupPosition);
    
    //返回尾部的viewType。
    public int getFooterViewType(int groupPosition) ;
    
    //返回子项的viewType。
    public int getChildViewType(int groupPosition, int childPosition) ;

设置点击事件的监听

GroupedListAdapter adapter = new GroupedListAdapter(this, GroupModel.getGroups(10, 5));
    adapter.setOnHeaderClickListener(new com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter.OnHeaderClickListener<GroupBean>() {
        @Override
        public void onHeaderClick(com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter adapter, HelperRecyclerViewHolder holder, int groupPosition, GroupBean item) {
        }
    });
    adapter.setOnFooterClickListener(new com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter.OnFooterClickListener<GroupBean>() {
        @Override
        public void onFooterClick(com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter adapter, HelperRecyclerViewHolder holder,
                                  int groupPosition, GroupBean item) {
        }
    });
    adapter.setOnChildClickListener(new com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter.OnChildClickListener<GroupBean>() {
        @Override
        public void onChildClick(com.zhouyou.recyclerview.group.GroupedRecyclerViewAdapter adapter, HelperRecyclerViewHolder holder,
                                 int groupPosition, int childPosition, GroupBean item) {
        }
    });
    rvList.setAdapter(adapter);

注：  
1.setLayoutManager()必须放在setAdapter之前，切记！切记！切记！  
2.更多功能使用讲解请参考本库demo中使用示例或者参考[donkingliang][]的github，此模块功能是集成作者的，在此非常感谢，同时也处理了对XRecyclerview的兼容、能够做到分组也支持刷新和加载更多，同时新增支持：追加状态页面的分组效果（请看demo）。

## 项目结构目录截图 ##

![0yC1DfwbpvZwTFPHSzu.png][]

一个漂亮而强大的RecyclerView

> 代码地址如下：  
> [http://www.demodashi.com/demo/13470.html][http_www.demodashi.com_demo_13470.html]

> 注：本文著作权归作者，由demo大师发表，拒绝转载，转载需要作者授权

[http_www.demodashi.com_demo_13470.html]: http://www.demodashi.com/demo/13470.html
[1.gif]: /images/20220512/f6f1700e8d904c65853a96d1df7ce30c.png
[2.gif]: https://github.com/zhou-you/EasyXRecyclerView/raw/master/screenshot/2.gif
[3.gif]: /images/20220512/c042318c4e4a498597d79cc610a6288c.png
[4.gif]: /images/20220512/ec1b20bb1402474bb429230631b8a2f3.png
[5.gif]: https://github.com/zhou-you/EasyXRecyclerView/raw/master/screenshot/5.gif
[6.gif]: https://github.com/zhou-you/EasyXRecyclerView/raw/master/screenshot/6.gif
[7.gif]: https://github.com/zhou-you/EasyXRecyclerView/raw/master/screenshot/7.gif
[8.gif]: https://github.com/zhou-you/EasyXRecyclerView/raw/master/screenshot/8.gif
[9.gif]: https://github.com/zhou-you/EasyXRecyclerView/raw/master/screenshot/9.gif
[10.gif]: https://github.com/zhou-you/EasyXRecyclerView/raw/master/screenshot/10.gif
[Link 1]: https://github.com/hongyangAndroid/Android-StickyNavLayout
[github_https_github.com_zhou-you_EasyXRecyclerView]: https://github.com/zhou-you/EasyXRecyclerView
[donkingliang]: https://github.com/donkingliang/GroupedRecyclerViewAdapter
[0yC1DfwbpvZwTFPHSzu.png]: /images/20220512/a878e43ecbbd4cd498137742e7fd1490.png