PullToRefresh--可自定义的下拉刷新上拉加载库

PullToRefresh

开发者能够使用 PullToRefresh 对各类控件实现下拉刷新或者上拉加载以及能够自定义刷新和加载部分的视图。

目前支持：ScrollView ，ListView，WebView，RecyclerView。

github地址：https://github.com/823546371/PullToRefresh

码云地址：http://git.oschina.net/jinwenfeng/PullToRefresh

欢迎star or fork

版本记录

v1.0.3

修复了滑动最小距离判断

v1.1.0

新增了空数据，加载中以及网络错误的3种状态页面

效果图

基本用法

一、添加 Gradle 依赖

目前只支持 Android Studio

compile 'com.jwenfeng.pulltorefresh:library:1.1.0'

二、布局文件

注意：内容控件 有且只能有一个，目前支持：ScrollView ，ListView，WebView，RecyclerView。

<?xml version="1.0" encoding="utf-8"?>
<com.jwenfeng.library.pulltorefresh.PullToRefreshLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/activity_main"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    
    <!-- 内容控件 有且只能有一个 -->
     <ScrollView
        android:layout_width="match_parent"
        android:layout_height="match_parent">
    
     </ScrollView>
    
</com.jwenfeng.library.pulltorefresh.PullToRefreshLayout>

三、在Activity或者Fragment中使用

pullToRefreshLayout.setRefreshListener(new BaseRefreshListener() {
            @Override
            public void refresh() {
                new Handler().postDelayed(new Runnable() {
                    @Override
                    public void run() {
                        // 结束刷新
                        pullToRefreshLayout.finishRefresh();
                    }
                }, 2000);
            }

            @Override
            public void loadMore() {
                new Handler().postDelayed(new Runnable() {
                    @Override
                    public void run() {
                        // 结束加载更多
                        pullToRefreshLayout.finishLoadMore();
                    }
                }, 2000);
            }
        });

四、自定义视图

自定义下拉刷新视图须要实现 HeadView 接口

public interface HeadView {

    /**
     * 开始下拉
     */
    void begin();

    /**
     * 回调的精度,单位为px
     *
     * @param progress 当前高度
     * @param all      总高度
     */
    void progress(float progress, float all);

    void finishing(float progress, float all);
    /**
     * 下拉完毕
     */
    void loading();

    /**
     * 看不见的状态
     */
    void normal();

    /**
     * 返回当前视图
     * */
    View getView();

}

具体请参考Demo中 HeadRefreshView

上拉加载更多用法和下拉刷新相似，具体参考 LoadMoreView.java

五、其余

能够设置下拉刷新和上拉加载控件的高度和拉取的最大高度，默认为60dp，最大拉取为120dp,可自行设置。

六、v1.1.0 新增自定义3中状态页面

截图

用法

XML

<com.jwenfeng.library.pulltorefresh.PullToRefreshLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/activity_recycler_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:view_error="@layout/layout_error"
    app:view_empty="@layout/layout_empty"
    app:view_loading="@layout/layout_loading">

</com.jwenfeng.library.pulltorefresh.PullToRefreshLayout>

app:view_error 网络错误页面

app:view_empty 空数据页面

app:view_loading 加载中页面

该三个属性能够不填写，默认样式为上图所示，能够自定义

java用法

pullToRefreshLayout.showView(ViewStatus.LOADING_STATUS);

设置须要显示的视图

// 获取页面
View error = pullToRefreshLayout.getView(ViewStatus.ERROR_STATUS);

获取所须要的视图view

注意 必定要在调用了设置相应的视图以后才能够调用获取页面，不然view为空

License

Copyright 2016-2017 jinwenfeng

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.