一个体验极好的轻量级下拉刷新、上拉加载更多的LightRefre
2018-08-28 本文已影响16人
100岁的Android工程师
一个体验极好的轻量级下拉刷新、上拉加载更多的LightRefresh库
效果图
普通视图RecyclerView
自定义的刷新头,基于贝塞尔水波(正在维护)
LightRefresh特点(轻量级!轻量级!轻量级!)
- 1.可以不要刷新头(支持拉动回弹效果,类似于qq的下拉刷新,体验非常好)
- 2.支持常用的控件(RecyclerView、ListView、WebView、ScrollView等等).
- 3.支持自定义事件分发和冲突处理.
- 4.支持自定义下拉刷新头和加载更多头.
- 5.支持多指触控,不会让整个布局抖动,这是目前大部分下拉刷新库都没有注意到的.
- 6.支持自动刷新.
- 7.支持固定不回弹布局.
如何使用
1.添加依赖:
在根 build.gradle 中添加maven:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
然后添加:
dependencies {
implementation 'com.github.BLCodes:LightRefresh:1.0.3-beta-2'
}
2.用一个framlayout(必须!!!) 包裹BounceLayout 和header (footer),比如:
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout
xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent"
android:layout_height="match_parent"
android:id="@+id/fl_root"
>
<!--the header or footer will be added here-->
<com.blcodes.views.refresh.BounceLayout
android:id="@+id/bl"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#eee"
>
<android.support.v7.widget.RecyclerView
android:id="@+id/rv_test"
android:layout_width="match_parent"
android:layout_height="match_parent"></android.support.v7.widget.RecyclerView>
</com.blcodes.views.refresh.BounceLayout>
</FrameLayout>
3.添加刷新头、上拉加载更过头(如果你不想让布局有回弹效果,可以使用setDisallowBounce这个方法):
//bounceLayout.setDisallowBounce(true);//disallow the BounceLayout bounce!!!!
FrameLayout rootView = findViewById(R.id.fl_root);
bounceLayout.setHeaderView(new DefaultHeader(this),rootView);//if HeaderView is null,it just bounce.
bounceLayout.setFooterView(new DefaultFooter(this),rootView);
4.设置事件分发和冲突处理回调,注意:一般情况下只有竖直方向有滚动直接在notForwarding方法中返回true,如果既有竖直方向的滚动又有水平方向的滚动,可以参照demo中的处理
RecyclerView recyclerView = findViewById(R.id.rv_test);
bounceLayout.setBounceHandler(new NormalBounceHandler(),recyclerView);
bounceLayout.setEventForwardingHelper(new EventForwardingHelper() {
@Override
public boolean notForwarding(float downX, float downY, float moveX, float moveY) {
return true;
}
});
5.添加下拉刷新和上拉加载的回调: 设置bounceLayout.setRefreshCompleted()
和bounceLayout.setLoadingMoreCompleted()
这一步非常重要,不要忘记了
bounceLayout.setBounceCallBack(new BounceCallBack() {
@Override
public void startRefresh() {
Log.i(TAG, "run: 开始刷新");
new Handler().postDelayed(new Runnable() {
@Override
public void run() {
ArrayList<String> data = new ArrayList<>();
for (int i = 0; i < 16; i++) {
data.add("新文本"+i);
}
adapter.setData(data);
bounceLayout.setRefreshCompleted();
Log.i(TAG, "run: 结束刷新");
}
},2000);
}
@Override
public void startLoadingMore() {
}
});
6.如果你需要自动刷新,可以设置:
bounceLayout.autoRefresh()
经正式上线项目测试,该库使用起来效果非常好,特别是在多指操作和回弹效果上,并且耦合性也比较低,如果有问题,可以给他们的开源团队提问,该库也在一直维护中,地址为:https://github.com/BLCodes/LightRefresh.