TLRLoadRefresh是一个支持ListView,RecycleView,ViewGroup等下拉刷新和上拉加载的UI组件,使用具有很大的灵活性。可以根据自己的不同需求来定义不同UI设计,可以灵活的自定义下拉刷新的Head和上拉加载的Foot,下面将介绍该控件的使用方法和设计思想,首先先看下效果。
下面对控件的属性坐下介绍,如果描述有不清楚的地方,大家可以自行运行demo查看,demo中也用到我自己写的一个缓存框架,TCache,也欢迎大家star。
<declare-styleable name="TLRLinearLayout">
<attr name="enableRefresh" format="boolean"/>
<attr name="enableLoad" format="boolean"/>
<attr name="refreshThreshold" format="float"/>
<attr name="loadThreshold" format="float"/>
<attr name="refreshMaxMoveDistance" format="dimension"/>
<attr name="loadMaxMoveDistance" format="dimension"/>
<attr name="closeAnimDuration" format="integer"/>
<attr name="openAnimDuration" format="integer"/>
<attr name="resistance" format="float"/>
<attr name="releaseRefresh" format="boolean"/>
<attr name="releaseLoad" format="boolean"/>
<attr name="keepHeadRefreshing" format="boolean"/>
<attr name="keepFootLoading" format="boolean"/>
<attr name="keepContentLayout">
<flag name="refresh" value="0x01"/>
<flag name="load" value="0x02"/>
</attr>
<attr name="canMoveHeadByTLR" format="boolean"/>
<attr name="canMoveFootByTLR" format="boolean"/>
</declare-styleable>
- enableRefresh 是否可以刷新
- enableLoad 是否可以加载
- refreshThreshold 可刷新系数,以Head View的高度为基础,默认是1.0f
- loadThreshold 可加载系数,以Foot View的高度为基础,默认是1.0f
- refreshMaxMoveDistance 刷新时,可下拉的最大高度,这个必须要大于加载系数计算的加载高度,否则无法触发刷新
- loadMaxMoveDistance 加载时,可上拉的最大高度,同上
- closeAnimDuration 刷新结束的动画时间
- openAnimDuration 自动刷新,打开Head的动画时间
- resistance 触摸滑动阻尼系数,系数越大,触摸滑动的越吃力
- releaseRefresh 是否释放刷新,默认是
- releaseLoad 是否释放加载,默认是
- keepHeadRefreshing 刷新时,是否保持Head View
- keepFootLoading 加载时,是否保持Foot View
- keepContentLayout 加载或刷新时,是否保持内容体部不移动
- canMoveHeadByTLR 刷新时,是否可以让Head View一起移动
- canMoveFootByTLR 加载时,是否可以让Foot View一起移动
<declare-styleable name="TLRLinearLayout_Layout">
<attr name="label" format="enum">
<enum name="head" value="1"/><!--标记view是刷新的head-->
<enum name="content" value="2"/><!--标记为可刷新体,TLRLinearLayout可以有多个刷新体,可以查看demo-->
<enum name="foot" value="3"/><!--标记view是加载的foot-->
</attr>
</declare-styleable>
TLRNestedLinearLayout子类是支持android的嵌套滑动,可以支持RecycleView,NestedScrollView等嵌套滑动view的下拉刷新和上拉加载,具体可以查看demo
public interface TLRUIHandler {
/**
* 指定view刷新状态的回调
*/
void onRefreshStatusChanged(View target, TLRLinearLayout.RefreshStatus status);
/**
* 指定view加载状态的回调
*/
void onLoadStatusChanged(View target, TLRLinearLayout.LoadStatus status);
/**
* 指定view坐标信息的回调
* @param target 哪个view触发的位置变化
* @param isRefresh 是否时刷新
* @param totalOffsetY touch Y方向移动的距离
* @param totalThresholdY Y方向通过刷新系数计算的移动距离
* @param offsetY Y方向相对移动的距离
* @param threshOffset Y方向移动变化系数
*/
void onOffsetChanged(View target, boolean isRefresh, int totalOffsetY, int totalThresholdY,
int offsetY, float threshOffset);
/**
* 刷新或加载完成时状态的回调
*/
void onFinish(View target, boolean isRefresh, boolean isSuccess, int errorCode);
}
在加载或刷新完成时,head或foot view有时想完成一些自己的动画,比如类似原生的MaterialHeaderView在加载完成时,想先做一个缩小动画,然后在让TLRLinearLayout完成剩下的动画,这时候就用到了TLRUIHandlerHook,具体可参考MaterialHeaderView实现。这种设计思想源自于android-Ultra-Pull-To-Refresh,感谢大牛们的贡献。
暂略
在实现过程中我参考了一些优秀的开源库,感谢这些无私的大牛们做出的贡献;这个库目前没有进一步封装,因为我还没有做过全面的测试,所以如果有问题欢迎大家指正,并提issues