android recycleView的进一步封装

HeaderAndFooterRecyclerView是支持addHeaderView、 addFooterView、分页加载的RecyclerView解决方案。

它可以对 RecyclerView 控件进行拓展(通过RecyclerView.Adapter实现),给RecyclerView增加HeaderView、FooterView,并且不需要对你的具体业务逻辑Adapter做任何修改。

同时,通过修改 FooterView State,可以动态 FooterView 赋予不同状态(加载中、加载失败、滑到最底等),可以实现 RecyclerView 分页加载数据时的 Loading/TheEnd/NetWorkError 效果。

https://github.com/cundong/HeaderAndFooterRecyclerView

使用

  • 添加HeaderView、FooterView
        mHeaderAndFooterRecyclerViewAdapter = new HeaderAndFooterRecyclerViewAdapter(mDataAdapter);
        mRecyclerView.setAdapter(mHeaderAndFooterRecyclerViewAdapter);

        mRecyclerView.setLayoutManager(new LinearLayoutManager(this));

        //add a HeaderView
        RecyclerViewUtils.setHeaderView(mRecyclerView, new SampleHeader(this));

        //add a FooterView
        RecyclerViewUtils.setFooterView(mRecyclerView, new SampleFooter(this));
  • LinearLayout/GridLayout/StaggeredGridLayout布局的RecyclerView分页加载
mRecyclerView.addOnScrollListener(mOnScrollListener);
private EndlessRecyclerOnScrollListener mOnScrollListener = new EndlessRecyclerOnScrollListener() {

        @Override
        public void onLoadNextPage(View view) {
            super.onLoadNextPage(view);

            LoadingFooter.State state = RecyclerViewStateUtils.getFooterViewState(mRecyclerView);
            if(state == LoadingFooter.State.Loading) {
                Log.d("@Cundong", "the state is Loading, just wait..");
                return;
            }

            mCurrentCounter = mDataList.size();

            if (mCurrentCounter < TOTAL_COUNTER) {
                // loading more
                RecyclerViewStateUtils.setFooterViewState(EndlessLinearLayoutActivity.this, mRecyclerView, REQUEST_COUNT, LoadingFooter.State.Loading, null);
                requestData();
            } else {
                //the end
                RecyclerViewStateUtils.setFooterViewState(EndlessLinearLayoutActivity.this, mRecyclerView, REQUEST_COUNT, LoadingFooter.State.TheEnd, null);
            }
        }
    };

注意事项

如果已经使用 RecyclerViewUtils.setHeaderView(mRecyclerView, view); 为RecyclerView添加了HeaderView,那么再调用ViewHolder类的getAdapterPosition()getLayoutPosition()时返回的值就会因为增加了Header而受影响(返回的position等于真实的position+headerCounter)。

因此,这种情况下请使用 RecyclerViewUtils.getAdapterPosition(mRecyclerView, ViewHolder.this)RecyclerViewUtils.getLayoutPosition(mRecyclerView, ViewHolder.this) 两个方法来替代。

Demo

  • 添加HeaderView、FooterView

截屏

  • 支持分页加载的LinearLayout布局RecyclerView

截屏

  • 支持分页加载的GridLayout布局RecyclerView

截屏

  • 支持分页加载的StaggeredGridLayout布局RecyclerView

截屏

  • 分页加载失败时的GridLayout布局RecyclerView

截屏

关于作者



2.ExRecyclerView

使用 Kotlin 编写, 可以添加 Header 和 Footer, 监听 Load More , 支持 Drag 和 Swipe Item

demo

很多时候我们在使用 RecyclerView 时, 总是会碰到需要设置一个 header 或者 footer 的情况, 比如我们要加一个显示加载更多的footer,跟随 RecyclerView 一起滑动的 header, 等等, 这种情况如果是 ListView 我们可以简单的使用 addHeaderView() 或者addFooterView() 就可以解决, 但是 RecyclerView 就需要我们自己来进行处理. 虽然说不困难, 但是每次都要重新实现一遍就很麻烦了.

ExRecyclerView一共实现了3个功能:

  1. 能添加和删除 header 和 footer
  2. 滑到底部时回调加载更多
  3. 支持 Drag 和 Swipe 拖动 item 或者 swipe 删除 item (可以自定义拖动,滑动的样式)

ExRecyclerAdapter 是一个内置了 List 集合的 RecyclerAdapter, 每次改变数据都会主动进行相应的notify(也可以主动不进行 notify)

ExRecyclerView

Usage

dependencies {
    compile 'cn.kejin.exrecyclerview:exrecyclerview:1.0.2'
}
<cn.kejin.exrecyclerview.ExRecyclerView
    android:id="@+id/exRecycler"
    android:layout_margin="50dp"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:header="@layout/layout_header"
    app:footer="@layout/layout_footer"/>
exRecycler.layoutManager = LinearLayoutManager(this)
exRecycler.adapter = Adapter(this)
exRecycler.addHeader(header)
exRecycler.addFooter(footer)

exRecycler.setOnLoadMoreListener {
    // do load more, 结束之后调用 exRecycler.endLoadMore() 结束loading more的状态
}

exRecycler.itemActionListener = listener
// 如果使用自定义 ItemTouchHelper
exRecycler.itemTouchHelper = customItemTouchHelper



PullRefreshLoadRecyclerView

RecyclerView can pull to refresh and load more with great user experience. Drag and Fling to over scroll with bounce like IOS.

中文介绍

拥有极棒体验的下拉刷新&上拉加载。接近IOS的触控体验&越界的回弹效果。

image


PowerfulRecyclerView

可以设置头、底操作:

https://github.com/zjutkz/PowerfulRecyclerView

参考博客:
http://zjutkz.net/2016/03/29/重复造轮子也是有意义的!PowerfulRecyclerView使用指导和源码分析/


PowerfulRecyclerViewAdapter

支持各种ViewHolder类型的RecyclerView.Adapter的实现,是一个万能适配器

项目地址:https://github.com/simplify20/PowerfulRecyclerViewAdapter 

特性:

  • 使用DataBean关联Data(Model)与ViewHolder;
  • DataBean控制ViewHolder的创建以及数据到ViewHolder的绑定;
  • Adapter的一部分职能由DataBean承担,如创建不同类型的ViewHolder以及绑定数据到ViewHolder,Adapter只用维护数据的相关操作即可;
  • Adapter的onCreateViewHolder和onBindViewHolder中没有switch..case语句,通过DataBean的多态性实现不同的创建和绑定;
  • 使用了本项目的Adapter,使用RecyclerView时就不用写Adapter了;
  • 支持任何种类的ViewHolder(继承自BaseRecyclerViewHolder)
  • 使用接口可以提高ViewHolder及Data的复用性,并且利于测试。




HVEndlessRecyclerView

自定义 RecyclerView 实现添加 footer,当然你想添加 header 也是支持的

项目地址:https://github.com/HelloVass/HVEndlessRecyclerView

Easy way implements loadmore

Thanks Cube-Sdk,秋哥的 loadmore 模块真的写得很好!

1.Click 事件支持

    // 支持 Click 事件
    mSampleAdapter.setOnItemClickListener(new OnRcvItemClickListener() {
      @Override public void onItemClick(View v, int position) {
        Toast.makeText(MainActivity.this, "点击事件支持,item position -->>" + position,
            Toast.LENGTH_SHORT).show();
      }
    });
    // 支持 LongClick 事件
    mSampleAdapter.setOnItemLongClickListener(new OnRcvItemLongClickListener() {
      @Override public boolean onItemLongClick(View view, int position) {
        Toast.makeText(MainActivity.this, "长按点击事件支持,item position -->>" + position,
            Toast.LENGTH_SHORT).show();
        return true;
      }
    });
    mRecyclerView.setAdapter(mSampleAdapter);
    mRecyclerView.useDefaultFooter(); // 请在 setAdapter 之后设置默认的 footer

3.加载更多数据

    mRecyclerView.setLoadMoreHandler(new ILoadMoreHandler() {
          @Override public void onLoadMore() {
            simulateLoadMoreData();
        }
      });

4. 加载完成之后,设置状态

  • 内容是否为空

  • 是否有更多数据

/**
   * 
   * @param isEmpty fetch 的数据列表是否为空
   * @param hasMore 是否还有更多数据
   */
  @Override public void onLoadMoreCompleted(boolean isEmpty, boolean hasMore) {

  }

5.加载失败

/**
   * 
   * @param errorCode 错误码
   * @param errorMsg 错误信息
   */
  @Override public void onLoadMoreFailed(int errorCode, String errorMsg) {

  }
/**
 *
 * 对 LoadMoreView 的抽象
 */
public interface ILoadMoreUIHandler {

  // 加载中
  void onLoading();
  // 加载完毕
  void onLoadFinish(boolean isEmpty, boolean hasMore);
  // 加载出错
  void onLoadError(int errorCode, String errorMsg);
  // 等待被点击加载更多
  void onWaitToLoadMore();
}

Tips

具体可以参考 DefaultLoadMoreFooterView 这个栗子

1.当 LayoutManager 为 LinearLayoutManager 时

2.当 LayoutManager 为 GridLayoutManager 时

3.当 LayoutManager 为 StaggeredGridLayoutManager 时

// 请自行想象...

QQ交流群 :232203809,欢迎入群 
这里写图片描述 
微信公众号:终端研发部 
(欢迎关注学习和交流)

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值