高小哥漫谈前端

技术咨询、项目合作、广告投放、简历咨询、技术文档下载点击这里联系博主

简介：使用RecyclerView封装headerview,footerView,并实现上拉加载更多，下拉刷新，分组功能(添加上拉加载和下拉刷新设置背景)

界面可能有点丑，😁，但是是为了展示所有效果，请大家见谅。（所有东西都是可自己设置的哦）😊
效果图：

main

如何获取:[![](https://jitpack.io/v/mrgaogang/luckly_recyclerview.svg)](https://jitpack.io/#mrgaogang/luckly_recyclerview)
第一步：在项目的build.gradle中添加
```Java allprojects { repositories { ... maven { url 'https://jitpack.io' } } } ``` 第二步：添加依赖
```Java dependencies { compile 'com.github.mrgaogang:luckly_recyclerview:v2.3.0' } ```

一、部分方法介绍

1、设置加载更多的监听事件
2、设置下拉刷新监听事件
3、添加分割线
4、添加错误视图
5、添加空视图
6、添加headerView
7、设置下拉刷新进度条的颜色和字体的颜色
8、设置监听事件
9、设置上拉加载和下拉刷新在不同的状态
10、设置是否空白视图和错误视图点击刷新
11、可设置下拉刷新和上拉加载的背景图片(可用于广告的放置哦)
12、局部刷新

二、如何实现分组

1、luckRecyclerView.setRecyclerViewType(LucklyRecyclerView.GROUP);
2、重写Adapter继承基类BaseGroupAdapter
3、常用的几个方法

三、具体如何使用请看例子

# 一、部分方法介绍

# 1、设置加载更多的监听事件

	mLRecyclerView.setLoadMoreListener(this);

并重写onLoadMore()方法。

# 2、设置下拉刷新监听事件

	mLRecyclerView.setOnRefreshListener(this);

并重写onRefresh()方法。

# 3、添加分割线

已经封装好了线性布局的分割线和网格式布局的分割线、流式布局的分割线。

	//线性布局
 	mLRecyclerView.addLinearDivider(LRecyclerView.VERTICAL_LIST);
	//网格式布局
   	 mLRecyclerView.addGridDivider();
	//可以指定颜色和宽度
	addGridDivider(int color, int dividerHeight)
	addLinearDivider(int oritation, int color, int lineWidth)

# 4、添加错误视图

当网络连接失败等情况的时候，需要显示错误视图。

	//添加错误的View
   	 mLRecyclerView.setErrorView(R.layout.error_view);
	//添加错误的View
	View error = LayoutInflater.from(this).inflate(R.layout.view_error, null, false);
   	 mLRecyclerView.setErrorView(error);

使用getErrorView()得到错误视图。

# 5、添加空视图

当数据为空的时候，需要显示。

	//添加空的View
  	  mLRecyclerView.setEmptyView(R.layout.empty_view);
	//添加空的View
	View empty = LayoutInflater.from(this).inflate(R.layout.view_empty, null, false);
   	 mLRecyclerView.setEmptyView(error);

使用getErrorView()得到空视图。

# 6、添加headerView

	//添加headerView
   	 mLRecyclerView.addHeaderView(R.layout.header_view);
	//添加headerView，需要设置父类为mLRecyclerView
	View headerView = LayoutInflater.from(this).inflate(R.layout.header_view, mLRecyclerView, false);
   	 mLRecyclerView.addHeaderView(headerView);

	//得到所有headerView视图。
	List<View> getHeaderViews();
	//得到所有headerView的个数。
	int getHeaderViewCount();

# 7、设置下拉刷新进度条的颜色和字体的颜色

	//改变下方加载进度的字体颜色
	mLRecyclerView.setLoadingTextColor(Color.BLUE);
	//改变下方加载进度条的颜色
	mLRecyclerView.setLoadingProgressColor(Color.BLUE);
	//修改下拉刷新颜色
	mLRecyclerView.setRefreshColor(getResources().getColor(R.color.colorAccent));

# 8、设置监听事件

 	//设置点击事件，注意此处返回的position是不包括headerView和不包括下拉加载的视图的
	mLRecyclerView.setOnItemClickListener(new LucklyRecyclerView.OnItemClickListener() {
        @Override
        public void onItemClick(int position) {
	//position为数据的位置
            Log.i(TAG,"点击--->"+position);
        }

        @Override
        public void onItemLongClick(int position) {
            Log.i(TAG,"长按--->"+position);
        }
	 });

# 9、设置上拉加载和下拉刷新在不同的状态

 @Override
    public void onLoadMore() {
        //设置处于正在加载状态
        mLRecyclerView.setLoading();
        new Handler().postDelayed(new Runnable() {
            @Override
            public void run() {
                int count = dataAdapter.getItemCount() + 1;
                if (count < 50) {
                    List<String> strings = new ArrayList<>();
                    for (int i = count - 1; i < 5 + count; i++) {
                        strings.add("数据" + i);
                    }
                    dataAdapter.addAll(strings);
                    //设置数据已经加载完成状态
                    mLRecyclerView.setLoadingComplete();
                } else {
                    //设置没有更多数据状态，可以自定义现实的文字，上述的两个状态也都可以自定义文字
                    mLRecyclerView.setLoadingNoMore("唉呀妈呀，没数据咯");
                }


            }
        }, 2000);
    }

   @Override
    public void onRefresh() {
        mLRecyclerView.setRefreshEnable(true);
        new Handler().postDelayed(new Runnable() {
            @Override
            public void run() {
                dataAdapter.clearAll();
                List<String> strings = new ArrayList<>();
                for (int i = 0; i < 30; i++) {
                    strings.add("数据" + i);
                }
                dataAdapter.addAll(strings);

            
                mLRecyclerView.setRefreshComplete();
            }
        }, 5000);
    }

# 10、设置是否空白视图和错误视图点击刷新

 mLRecyclerView.setOnClickEmptyOrErrorToRefresh(true);

# 11、可设置下拉刷新和上拉加载的背景图片(可用于广告的放置哦)

注意:

如果在初始化的时候直接设置了背景图片可不用刷新adapter。
如果通过网络获取到背景图片之后可以使用如下方法设置背景，但是需要添加一步：notifyItemChanged()

    //设置下拉刷新的背景图片（可放广告图片哦）
    mLRecyclerView.setRefreshBackground(getResources().getDrawable(R.drawable.headerback));
    //设置上拉加载部分设置背景图片（也可放广告哦）
    mLRecyclerView.setFooterBackground(getResources().getDrawable(R.drawable.footerback));
  	
    //如果通过网络获取的footer图片，则需要调用以下：（如果是设置刷新部分的背景直接调用setRefreshBackground）
     mLRecyclerView.getOriginalRecyclerView().getAdapter()
		.notifyItemChanged(mLRecyclerView.getOriginalRecyclerView().getAdapter().getItemCount() - 1);

# 12、局部刷新

注意：使用局部刷新时要加上offset

  /*
        * 关于position:
        * 1、在自定义Adapter的时候 position是自己定义的数据0-length-1
        *

        *
        * */
        //设置点击事件，注意此处返回的position是不包括headerView  不包括下拉刷新的
        mLRecyclerView.setOnItemClickListener(new LucklyRecyclerView.OnItemClickListener() {
            @Override
            public void onItemClick(View view, int position) {
                //此处返回的position为数据的position，不包括 添加的头部和下拉刷新
                Log.i(TAG, "点击--->" + position);

                //在进行局部刷新的时候 一定要记得加上offsetcount,偏移量；使用局部刷新记得notifyItemChanged第二个参数不要为空
                    dataAdapter.notifyItemChanged(position+mLRecyclerView.getOffsetCount(), ">>>>>>刷新");


            }

            @Override
            public void onItemLongClick(View view, int position) {
                TextView textView = (TextView) view.findViewById(R.id.item);
                textView.setText("长按" + position);
                Log.i(TAG, "长按--->" + position);
            }


        });

# 二、如何实现分组

# 1、luckRecyclerView.setRecyclerViewType(LucklyRecyclerView.GROUP);

# 2、重写Adapter继承基类BaseGroupAdapter

需要重写的几个方法：

  /**
     * 第一层的数量
     *
     * @return
     */
    public abstract int getParentCount();

    /**
     * 每一个parent下的child的数量
     *
     * @param parentPosition
     * @return
     */
    public abstract int getChildCountForParent(int parentPosition);

    public abstract A onCreateParentViewHolder(ViewGroup parent, int viewType);

    public abstract B onCreateChildViewHolder(ViewGroup parent, int viewType);

    public abstract void onBindParentViewHolder(A holder, int position);

    /**
     * 分别是hoder,parent的位置（全局的位置）
     * child在parent中的index(不是position)
     *
     * @param holder
     * @param parentPosition
     * @param childIndexForParent
     */
    public abstract void onBindChildViewHolder(B holder, int parentPosition, int childIndexForParent);

在使用点击事件的时候要注意判断是否为Parent：

   luckRecyclerView.setOnItemClickListener(new LucklyRecyclerView.OnItemClickListener() {
            @Override
            public void onItemClick(View rootView, int position) {
                if (mGroupAdapter.isParentView(position)){
                    mGroupAdapter.showChild(rootView);
                }else {
                    Toast.makeText(getApplicationContext(),"点击了第"+mGroupAdapter.getParentIndexFromChild(position)+"个parent的"+mGroupAdapter.getChildIndexForParent(position),Toast.LENGTH_SHORT).show();
                }
            }

            @Override
            public void onItemLongClick(View rootView, int position) {

            }
        });

# 3、常用的几个方法

1、获取child在parent下的index

mGroupAdapter.getChildIndexForParent(position);

2、获取parent的index

mGroupAdapter.getParentIndexFromChild(position);

3、判断当前position是否为parentView

mGroupAdapter.isParentView(position);

# 三、具体如何使用请看例子

LucklyRecyclerView (opens new window)

欢迎关注我的微信公众号：

本文作者： mrgaogang.github.io
本文链接： https://mrgaogang.github.io/open/luckly_recyclerview.html
版权声明： 本博客所有文章除特别声明外，均采用 CC BY-SA 4.0 许可协议。转载请注明出处！

← /open/ /open/record.html →