Skip to content

borneywpf/TLRLoadRefresh

Repository files navigation

TLRLoadRefresh

TLRLoadRefresh是一个支持ListView,RecycleView,ViewGroup等下拉刷新和上拉加载的UI组件,使用具有很大的灵活性。可以根据自己的不同需求来定义不同UI设计,可以灵活的自定义下拉刷新的Head和上拉加载的Foot,下面将介绍该控件的使用方法和设计思想,首先先看下效果。

1 2 3 4

控件属性介绍

下面对控件的属性坐下介绍,如果描述有不清楚的地方,大家可以自行运行demo查看,demo中也用到我自己写的一个缓存框架,TCache,也欢迎大家star。

TLRLinearLayout属性介绍,如下:

    <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一起移动

TLRLinearLayout子控件label设置

    <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>

TLRLinearLayout子类TLRNestedLinearLayout

TLRNestedLinearLayout子类是支持android的嵌套滑动,可以支持RecycleView,NestedScrollView等嵌套滑动view的下拉刷新和上拉加载,具体可以查看demo

回调接口TLRUIHandler介绍

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);
}

刷新或加载完成时hook keepview接口TLRUIHandlerHook

在加载或刷新完成时,head或foot view有时想完成一些自己的动画,比如类似原生的MaterialHeaderView在加载完成时,想先做一个缩小动画,然后在让TLRLinearLayout完成剩下的动画,这时候就用到了TLRUIHandlerHook,具体可参考MaterialHeaderView实现。这种设计思想源自于android-Ultra-Pull-To-Refresh,感谢大牛们的贡献。

实现原理介绍

暂略

总结

在实现过程中我参考了一些优秀的开源库,感谢这些无私的大牛们做出的贡献;这个库目前没有进一步封装,因为我还没有做过全面的测试,所以如果有问题欢迎大家指正,并提issues

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published