自定义头部,支持任意布局的下拉刷新。
- 在Project的build.gradle文件里面加入
allprojects {
repositories {
google()
jcenter()
maven {
url "https://dl.bintray.com/caijialib/caijiaLibray"
}
}
}
- 在Module的build.gradle文件里面加入
compile 'com.caijia:refreshlayout:1.0.1'
#Usage
- 布局文件
<com.caijia.refreshlayout.RefreshLayout
android:id="@+id/refresh_layout"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:refreshHeaderId="@layout/common_view_home_refresh_header">
<android.support.v7.widget.RecyclerView
android:id="@+id/rv_music"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</com.caijia.refreshlayout.RefreshLayout>
common_view_home_refresh_header.xml
<?xml version="1.0" encoding="utf-8"?>
<com.caijia.refreshlayout.header.ClassicRefreshHeaderView xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="64dp"
android:orientation="vertical" />
#代码调用
- 常规调用。初始化调用,在onRefresh()回调里面刷新
refreshLayout.setOnRefreshListener(this);
- 刷新完成调用
refreshLayout.setRefreshing(false);
- 自动刷新。不需要手指下拉触发刷新
refreshLayout.setRefreshing(false);
- 自定义触发刷新的条件,默认是当内容控件达到顶部 ,并且向下拉时触发
setOnChildScrollUpCallback(OnChildScrollUpCallback callback)
public interface OnChildScrollUpCallback {
boolean canChildScrollUp(RefreshLayout parent, View child);
}
RefreshLayout自定义属性
| 属性 | 含义 | 默认值 | 是否必填 |
|---|---|---|---|
| closeHeaderDelay | 当刷新完成,延时多久关闭头部 | 500ms | 否 |
| dragRadio | 下拉的阻尼参数 | 0.4f(如果手指移动100px,那么下拉40px) | 否 |
| isHeaderFrontTarget | 头部是否在滚动内容的上面 | true | 否 |
| isRefreshEnable | 是否可以刷新 | true | 否 |
| isRefreshingPinHeader | 刷新时头部是否固定 | false | 否 |
| refreshHeaderId | 头部的自定义layout | 无 | 是 |
- 头部的自定义,默认是ClassicRefreshHeaderView,当传refreshHeaderId里面的布局必须实现RefreshLayout.RefreshBehavior接口
public interface RefreshBehavior {
void onStart(float headerViewHeight, int refreshDistance);
void onMove(float move, float headerViewHeight, int refreshDistance);
void onRefreshing();
void onRefreshComplete();
void onReset();
int refreshDistance(int headerViewHeight);
int dragRange(int headerViewHeight);
boolean onLayoutChild(View headerView, View target);
int animationDuration(@Px int distance);
}
- 当下拉开始时调用
void onStart(float headerViewHeight, int refreshDistance);
| 参数 | 含义 |
|---|---|
| headerViewHeight | 自定义头部的高度 |
| refreshDistance | 刷新的距离,当下拉达到此距离时,松开手指开始刷新,刷新临界值 |
- 移动回调
void onMove(float move, float headerViewHeight, int refreshDistance);
| 参数 | 含义 |
|---|---|
| move | 移动的距离 |
| headerViewHeight | 自定义头部的高度 |
| refreshDistance | 刷新的距离,当下拉达到此距离时,松开手指开始刷新,刷新临界值 |
- 正在刷新回调
void onRefreshing();
4.刷新完成,刷新完成并不是回到初始位置,头部还没有缩回。
void onRefreshComplete();
- 重置,回调了初始位置,头部缩回。
void onReset();
6.调整刷新临界值,这个值默认是头部高度,可以自定义这个值,
int refreshDistance(int headerViewHeight);
7.调整下拉的范围,最大下拉只能到达这个值
int dragRange(int headerViewHeight)
8.调整头部布局,和内容布局的位置,默认是上下排列
boolean onLayoutChild(View headerView, View target)
9.调整头部缩回的速度
int animationDuration(@Px int distance)
####### 你可能会问,为什么没有加载更多。个人觉得加载更多应该是滚动控件的范畴。 写这个控件的主要目的当然是自己项目使用,其次可以说是自定义控件的一个总结。其次是找了一些刷新,发现阅读起来还不如自己写一个。 当然发现的一些问题。在这个项目里面也是重点解决。包括有些刷新滑动到顶部,如果不松手不能下拉。不能自定义头部的。不能自定义触发刷新的。不能嵌套ViewPager,刷新时不能滚动控件的。