LoadMoreWrapper

Project Url: nukc/LoadMoreWrapper
Introduction: 📦 在不改动 RecyclerView 原有的 adapter 的情况下,使 RecyclerView 滑动到底部的时候能够加载更多和自定义底部视图。
More: Author   ReportBugs   
Tags:

Build Status Download

make recyclerView supports load more and customize the footer view, without changes to the original adater of recyclerView.

在不改动 RecyclerView 原有 adapter 的情况下,使其拥有加载更多功能和自定义底部视图。

  • 支持当 item 未铺满屏幕的时候仍能够加载更多
  • 支持自定义加载视图
  • 当 layoutManager 为 Grid 和 StaggeredGrid 的时候, 加载更多视图 footerView 仍占据一行
  • 支持设置是否显示没有更多视图,可自定义
  • 支持设置加载失败视图,点击会自动触发加载更多事件

Installation

JCenter:

add the dependency to your build.gradle:

    implementation 'com.github.nukc:loadmorewrapper:1.9.1'

JitPack:

Step 1. Add the JitPack repository to your build file Add it in your root build.gradle at the end of repositories:

    allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }

Step 2. Add the dependency

    dependencies {
        implementation 'com.github.nukc:LoadMoreWrapper:v1.9.1'
    }

Usage

    //the adapter is the original (这个 adapter 是原有的, 不改动它)
    LoadMoreWrapper.with(adapter)
        .setFooterView(...) // view or layout resource
        .setShowNoMoreEnabled(true) // enable show NoMoreView,default false
        .setListener(new LoadMoreAdapter.OnLoadMoreListener() {
             @Override
             public void onLoadMore(LoadMoreAdapter.Enabled enabled) {
                 // do something
                 // you can enabled.setLoadMoreEnabled(false) when do not need load more
                 // you can enabled.setLoadFailed(true) when load failed
             })
        .into(recyclerView);

or

in the original adapter: demo

    private static class AnotherAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {

        private LoadMoreWrapper mWrapper;

        // code..

        @Override
        public void onAttachedToRecyclerView(RecyclerView recyclerView) {
            super.onAttachedToRecyclerView(recyclerView);

            mWrapper = LoadMoreWrapper.with(this);
            mWrapper.setListener(
                    new LoadMoreAdapter.OnLoadMoreListener() {
                        @Override
                        public void onLoadMore(LoadMoreAdapter.Enabled enabled) {
                            // do something
                        }
                    })
                    .setShowNoMoreEnabled(true)
                    .into(recyclerView);
        }

    }
方法名 备注
setLoadMoreEnabled(boolean enabled) 设置是否启用加载更多,默认 true
setShowNoMoreEnabled(boolean enabled) 设置全部加载完后是否显示没有更多视图,默认 false
setLoadFailed(boolean isLoadFailed) 设置是否加载失败,默认 false
setNotShowFooterWhenNotCoveredScreen(boolean notShow) 设置在 item 未铺满屏幕的时候是否不显示底部视图,默认 false
getOriginalAdapter() 获取原来的 adapter
getFooterView 获取加载更多视图
getNoMoreView 获取没有更多视图
getLoadFailedView 获取加载失败视图

注意:当加载完全部后且已 setLoadMoreEnabled(false),但如果由于生命周期或其他问题而导致 View 重建,mLoadMoreEnabled 依然为 true。 这时候应该需要保存 mLoadMoreEnabled 的状态,如果是 ViewPager + Fragment,可以使用 setOffscreenPageLimit 进行解决。

License

Copyright 2016 nukc

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Apps
About Me
GitHub: Trinea
Facebook: Dev Tools