前言
下拉刷新与上滑加载作为经典的交互动作,几乎已经成了各大App的标配。Google也是在support包中加入了SwipeRefreshLayout, 一个符合MaterialDesign规范的下拉刷新布局。美中不足的是该布局不支持上滑加载更多。GitHub上面有不少直接扩展ListView或者RecyclerView的例子,但我觉得刷新布局还是应该作为内容视图的父控件,并且同时支持ListView和RecyclerView会更加方便。因此自己动手写了一个轮子——RefreshLoadLayout。
- 既支持上滑加载又支持下拉刷新
- 下拉刷新支持几乎所有View,并且可以通过设置回调来判断内容视图是否还能继续上滑/下滑。而上滑加载由于要考虑Fling,目前只做了AbsListView和RecyclerView的适配,相信已经可以满足绝大多数加载更多的需求。
- 支持NestedScrolling机制
使用介绍
-
添加 gralde 依赖
**compile 'com.github.refreshloadlayout:refreshloadlayout:0.0.4' **
如果收到支持库不统一的警告,可修改为 compile ('com.github.refreshloadlayout:refreshloadlayout:0.0.4'){exclude group: 'com.android.support'} -
在布局中使用
<com.github.refreshloadlayout.RefreshLoadLayout
android:id="@+id/refreshLayout"
app:loadingEnabled="true"
app:refreshingEnabled="true"
android:layout_width="match_parent"
android:layout_height="match_parent">
<ListView
android:id="@+id/listView"
android:background="#fff"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</com.github.refreshloadlayout.RefreshLoadLayout> -
下拉刷新
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<String> arrayAdapter= (ArrayAdapter<String>) 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();
获取当前的指示器控件。进而对提示文字与背景颜色等调整。
同时支持扩展 RefreshIndicator 和 LoadMoreIndicator 接口来打造自己的指示器,在相应的回调中更新视图达到理想的效果。之后可将指示器设置为自定义的View。
比如设置 Material 效果的指示器:
MaterialIndicator materialIndicator=new MaterialIndicator(this);
materialIndicator.getProgressView().setColorSchemeColors(Color.RED,Color.YELLOW);
refreshLoadLayout.setRefreshIndicator(materialIndicator);
总结
使用上总体还是比较简单的,有需要的朋友可以添加到自己的项目中试试。项目已开源至 GitHub, 有问题欢迎提issue,我会尽快处理。如果对你有帮助,还请右上角star :)
网友评论