Android-Ultra-Pull-To-Refresh 下拉刷新控件

Android-Ultra-Pull-To-Refresh框架

看看：效果

一步下载jar包或aar文件 

android-Ultra-Pull-To-Refresh的特点是：内置各种下拉刷新交互风格。遗憾的是这个库不支持上拉加载更多。

android-Ultra-Pull-To-Refresh （简称 UltraPTR ）是一个强大的 Andriod 下拉刷新框架。 
1.继承自ViewGroup，Content可以包含任何View； 
2.简洁完善的Header抽象，方便进行扩展，构建满足需求的Header；

对比于Android-PullToRefresh 来说，UltraPTR没有实现上拉加载，作者认为上拉加载于下拉刷新不是同一个层次的功能，上拉加载应该交由Content自己去实现；Googgle官方的SwipeRefreshLayout也是这样认为的，对比SwipeRefreshLayout，UltraPTR更加灵活，更容易扩展。

PtrFrameLayout代表了一个下拉刷新的自定义控件。 
PtrFrameLayout继承自ViewGroup，有且只能有两个子View，头部Header和内容Content。通常情况下，Header会实现PtrUIHandler接口，Content可以为任意的View。 
和所有的自定义控件一样，PtrFrameLayout通过重写onFinishInflate、onMeasure、onLayout来确定控件的大小和位置，通过重写dispatchTouchEvent来确定控件的下拉行为。

//使用上主要分四步
        //1、设置头部
        initHeaders();//方法
        //2、添加头部
        ptr.setHeaderView(header);
        //3、处理下拉刷新过程中头部UI的变化

        //4、判断是否可以下拉，数据刷新工作。




        ptr.setPtrHandler(new PtrDefaultHandler() {

            @Override
            public void onRefreshBegin(PtrFrameLayout ptrFrameLayout) {//设置刷新回调
                ptr.refreshComplete();//一般使用这个   就是表示数据更新完之后可以使用他来啦会去指定地点
//                ptrFrameLayout.postDelayed(new Runnable() {
//                    @Override
//                    public void run() {
//                        ptr.refreshComplete();
//                    }
//                },
//                  1500//输入时间);

            }
            //判断是否可以下拉刷新。
            //UltraPTR 的 Content 可以包含任何内容，用户在这里判断决定是否可以下拉。
//例如，如果 Content 是 TextView，则可以直接返回 true，表示可以下拉刷新。
//如果 Content 是 ListView，当第一条在顶部时返回 true，表示可以下拉刷新。
//如果 Content 是 ScrollView，当滑动到顶部时返回 true，表示可以刷新。
            @Override
            public boolean checkCanDoRefresh(PtrFrameLayout frame, View content, View header) {
                //listView表示你要刷洗的数据如果不写就给上一层处理  如果返回true就自动处理
                return super.checkCanDoRefresh(frame,listView,header);
            }
        });

开发步骤：

第一步:

导入相关jar或aar

创建一个ListView不用多说 , 各位读者学到这里一个会创建一个ListVIew;  随便创一个

第二步:

使用框架的内部的自定义控件包裹一个ListView

看图:

第三步:

初始化:

listView = findViewById(R.id.listView);
        final PtrClassicFrameLayout ptr= findViewById(R.id.ptr);
        
        //4、判断是否可以下拉，数据刷新工作。

        ptr.setPtrHandler(new PtrDefaultHandler() {

            @Override
            public void onRefreshBegin(PtrFrameLayout ptrFrameLayout) {//设置刷新回调
                ptr.refreshComplete();//一般使用这个   就是表示数据更新完之后可以使用他来啦会去指定地点
//                ptrFrameLayout.postDelayed(new Runnable() {
//                    @Override
//                    public void run() {
//                        ptr.refreshComplete();
//                    }
//                },
//                  1500//输入时间);

            }
            //判断是否可以下拉刷新。
            //UltraPTR 的 Content 可以包含任何内容，用户在这里判断决定是否可以下拉。
//例如，如果 Content 是 TextView，则可以直接返回 true，表示可以下拉刷新。
//如果 Content 是 ListView，当第一条在顶部时返回 true，表示可以下拉刷新。
//如果 Content 是 ScrollView，当滑动到顶部时返回 true，表示可以刷新。
            @Override
            public boolean checkCanDoRefresh(PtrFrameLayout frame, View content, View header) {
                //listView表示你要刷洗的数据如果不写就给上一层处理  如果返回true就自动处理
                return super.checkCanDoRefresh(frame,listView,header);
            }
        });
        ArrayList<String> list = new ArrayList<>();
        for (int i=0;i<50;i++){
            list.add("测试Pull-To-Refresh"+i);
        }
        MyAdapter adapter = new MyAdapter(list,this);
        listView.setAdapter(adapter);

头部风格

/**
         * //第一种头部
         * StoreHouse风格的头部实现
         */
        storeHouseHeader = new StoreHouseHeader(this);
        storeHouseHeader.setBackgroundColor(Color.BLACK);
        storeHouseHeader.setTextColor(Color.WHITE);
        storeHouseHeader.setLineWidth(5);
        storeHouseHeader.initWithString("ENGLISH ONLY HAHA");    //只可英文，中文不可运行(添加时间)
        //"last update @" + new SimpleDateFormat("yyyy-MM-dd HH：mm:ss").format(new Date())

        /**
         * //第二种头部
         * Material Design风格的头部实现
         */
        materialHeader = new MaterialHeader(this);
        materialHeader.setColorSchemeColors(new int[]{Color.RED, Color.GREEN, Color.BLUE});//类似SwipeRefreshLayout


        /**
         * //第三种头部
         * 经典 风格的头部实现
         */
        ptrClassicDefaultHeader = new PtrClassicDefaultHeader(this);

有6个参数可配置:

阻尼系数：Resistance
//默认: 1.7f，越大，感觉下拉时越吃力。

触发刷新时移动的位置比例：RatioOfHeaderHeightToRefresh
//默认，1.2f，移动达到头部高度1.2倍时可触发刷新操作。

回弹延时：DurationToClose
//默认 200ms，回弹到刷新高度所用时间

头部回弹时间：DurationToCloseHeader
//默认1000ms

刷新是保持头部：KeepHeaderWhenRefresh
//默认值 true.

下拉刷新 / 释放刷新：PullToRefresh
//默认为释放刷新,默认false

xml中配置头部参数：

<in.srain.cube.views.ptr.PtrFrameLayout  
    android:id="@+id/store_house_ptr_frame"  
    xmlns:cube_ptr="http://schemas.android.com/apk/res-auto"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  

    cube_ptr:ptr_resistance="1.7"  
    cube_ptr:ptr_ratio_of_header_height_to_refresh="1.2"  
    cube_ptr:ptr_duration_to_close="300"  
    cube_ptr:ptr_duration_to_close_header="2000"  
    cube_ptr:ptr_keep_header_when_refresh="true"  
    cube_ptr:ptr_pull_to_fresh="false" >  

    <LinearLayout  
        android:id="@+id/store_house_ptr_image_content"  
        android:layout_width="match_parent"  
        android:layout_height="match_parent"  
        android:background="@color/cube_mints_333333"  
        android:clickable="true"  
        android:padding="10dp">  

        <in.srain.cube.image.CubeImageView  
            android:id="@+id/store_house_ptr_image"  
            android:layout_width="match_parent"  
            android:layout_height="match_parent" />  
    </LinearLayout>  

</in.srain.cube.views.ptr.PtrFrameLayout>

java代码中也可设置头部参数：

// the following are default settings  
mPtrFrame.setResistance(1.7f);  
mPtrFrame.setRatioOfHeaderHeightToRefresh(1.2f);  
mPtrFrame.setDurationToClose(200);  
mPtrFrame.setDurationToCloseHeader(1000);  
// default is false  
mPtrFrame.setPullToRefresh(false);  
// default is true  
mPtrFrame.setKeepHeaderWhenRefresh(true);