打造自己的下拉刷新+上滑加载框架

前言

下拉刷新与上滑加载作为经典的交互动作,几乎已经成了各大App的标配。Google也是在support包中加入了SwipeRefreshLayout, 一个符合MaterialDesign规范的下拉刷新布局。美中不足的是该布局不支持上滑加载更多。GitHub上面有不少直接扩展ListView或者RecyclerView的例子,但我觉得刷新布局还是应该作为内容视图的父控件,并且同时支持ListView和RecyclerView会更加方便。因此自己动手写了一个轮子——RefreshLoadLayout。

  • 既支持上滑加载又支持下拉刷新
  • 下拉刷新支持几乎所有View,并且可以通过设置回调来判断内容视图是否还能继续上滑/下滑。而上滑加载由于要考虑Fling,目前只做了AbsListView和RecyclerView的适配,相信已经可以满足绝大多数加载更多的需求。
  • 支持NestedScrolling机制
demo

使用介绍

  • 添加 gralde 依赖
    **compile 'com.github.refreshloadlayout:refreshloadlayout:0.0.4' **
    如果收到支持库不统一的警告,可修改为 compile ('com.github.refreshloadlayout:refreshloadlayout:0.0.4'){exclude group: 'com.android.support'}

  • 在布局中使用
    android:id="@+id/refreshLayout"
    app:loadingEnabled="true"
    app:refreshingEnabled="true"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    android:id="@+id/listView"
    android:background="#fff"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

  • 下拉刷新

    refreshLoadLayout.setOnRefreshListener(new RefreshLoadLayout.OnRefreshListener() {
        @Override
        public void onRefresh() {
            refreshLoadLayout.postDelayed(new Runnable() {
                @Override
                public void run() {
                    refreshLoadLayout.endRefreshing();
                }
            }, 3000);
        }
    });
  • 上滑加载

      refreshLoadLayout.setLoadingHandler(new RefreshLoadLayout.LoadingHandler() {
          @Override
          public boolean canLoadMore() {
              return listView.getCount()<26;
          }
    
          @Override
          public void onLoading() {
              refreshLoadLayout.postDelayed(new Runnable() {
                  @Override
                  public void run() {
                      ArrayAdapter arrayAdapter= (ArrayAdapter) listView.getAdapter();
                      arrayAdapter.add("a new data");
                      arrayAdapter.add("a new data");
                      refreshLoadLayout.endLoading();
                  }
              }, 2000);
    
          }
      });
    

其中 canLoadMore() 方法返回当前是否可以进行加载,即是否还有更多内容。
可设置是否需要在加载结束后将内容视图下滑一定距离,默认开启:
refreshLoadLayout.setScrollDownAfterLoading(false);

  • 启用/关闭功能
    默认开启下拉刷新关闭上滑加载更多,可以在xml中指定或者在代码中修改。
    refreshLoadLayout.setRefreshingEnabled(false);
    refreshLoadLayout.setLoadingEnabled(true);

  • UI定制
    目前共有两种指示器显示效果,默认实现的是仿新浪微博的,还有一种是Material 效果。
    首先可以通过 refreshLoadLayout.getRefreshIndicator();refreshLoadLayout.getLoadMoreIndicator(); 获取当前的指示器控件。进而对提示文字与背景颜色等调整。
    同时支持扩展 RefreshIndicatorLoadMoreIndicator 接口来打造自己的指示器,在相应的回调中更新视图达到理想的效果。之后可将指示器设置为自定义的View。
    比如设置 Material 效果的指示器:
    MaterialIndicator materialIndicator=new MaterialIndicator(this);
    materialIndicator.getProgressView().setColorSchemeColors(Color.RED,Color.YELLOW);
    refreshLoadLayout.setRefreshIndicator(materialIndicator);

总结

使用上总体还是比较简单的,有需要的朋友可以添加到自己的项目中试试。项目已开源至 GitHub, 有问题欢迎提issue,我会尽快处理。如果对你有帮助,还请右上角star :)

你可能感兴趣的:(打造自己的下拉刷新+上滑加载框架)