一个漂亮而强大的RecyclerView

代码地址如下：
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

演示

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