Android下拉刷新,上拉加载——Ultra-Pull-To-Refresh-With-Load-More(一)

个人博客:haichenyi.com。感谢关注

简介

Android里面刷新和分页加载是常见的,刷新有Google的SwipeRefreshLayout,但是UI不同意,非要跟IOS一样,那就没办法了。

开源框架链接:Ultra-Pull-To-Refresh-With-Load-More。这个开源框架是基于Ultra-Pull-To-Refresh拓展了一个上拉加载功能。

作者:廖祜秋

依赖


implementation 'in.srain.cube:ptr-load-more:1.0.6'

用法

整个项目就只有一个核心类:PtrFrameLayout,继承ViewGroup。步骤:

  1. xml里面定义控件PtrFrameLayout

  2. 设置相关属性

  3. 添加Header,Footer,并监听

  4. 监听刷新过程

第一步:xml里面定义控件PtrFrameLayout

<?xml version="1.0" encoding="utf-8"?>
<in.srain.cube.views.ptr.PtrFrameLayout
    android:id="@+id/ptr_frame_layout"
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:cube_ptr="http://schemas.android.com/apk/res-auto"

    cube_ptr:ptr_resistance_header="1.7"
    cube_ptr:ptr_ratio_of_header_height_to_refresh="1.2"
    cube_ptr:ptr_duration_to_back_header="300"
    cube_ptr:ptr_duration_to_close_header="2000"
    cube_ptr:ptr_keep_header_when_refresh="true"
    cube_ptr:ptr_pull_to_fresh="false"

    cube_ptr:ptr_resistance_footer="1.3"
    cube_ptr:ptr_duration_to_back_footer="300"
    cube_ptr:ptr_duration_to_close_footer="2000">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <TextView
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:background="@color/colorAccent"
            android:gravity="center"
            android:text="textView"/>
    </LinearLayout>
</in.srain.cube.views.ptr.PtrFrameLayout>

上面就是一个简单的布局,根布局是 PtrFrameLayout ,他的子View可以是任意view。

第二步:设置相关属性

我们也看到了,他的布局里面有一些自定义属性,可以在布局里面设置,也可以在java代码里面设置,相关属性含义如下:

  1. Resistence:阻尼系数,可以分别设置header和footer。默认: 1.7f,越大,感觉下拉刷新时越吃力。上拉加载也是一样的

  2. Ratio of the Height of the Header to Refresh:触发刷新时移动的位置比例。
    默认,1.2f,移动达到头部高度1.2倍时可触发刷新操作。下拉刷新,上拉加载都一样。

  3. Duration to Close back:回弹延时。默认 200ms,回弹到刷新或者高度所用时间,可以跟上面一样分开设置,也可以设置一个

  4. Duration to Close Header:刷新完成之后隐藏头部的时间。默认1000mscube_ptr:ptr_duration_to_close_either=”2000″

  5. Keep Header while Refreshing:刷新是保持头部,也就是显示头部。默认值 true。false:隐藏头部

  6. Pull to Refresh / Release to Refresh:下拉刷新 / 释放刷新。
    默认为释放的时候刷新

在java代码中设置方式如下:

final PtrFrameLayout ptrFrameLayout = findViewById(R.id.ptr_frame_layout);
//配置头部参数,可以在xml中设置
// the following are default settings
    ptrFrameLayout.setResistance(1.7f);
    ptrFrameLayout.setRatioOfHeaderHeightToRefresh(1.2f);
    ptrFrameLayout.setDurationToClose(200);
    ptrFrameLayout.setDurationToCloseHeader(1000);
// default is false
    ptrFrameLayout.setPullToRefresh(false);
// default is true
    ptrFrameLayout.setKeepHeaderWhenRefresh(true);

第三步:添加Header,Footer,并监听

//第一种头部,StoreHouse风格的头部实现
    /*StoreHouseHeader storeHouseHeader = new StoreHouseHeader(this);
    storeHouseHeader.setPadding(0,100,0,0);
    storeHouseHeader.setBackgroundColor(Color.BLACK);
    storeHouseHeader.setTextColor(Color.WHITE);
    storeHouseHeader.initWithString("haichenyi");//只可英文,中文不可运行(添加时间)
    ptrFrameLayout.setHeaderView(storeHouseHeader);
    ptrFrameLayout.addPtrUIHandler(storeHouseHeader);*/

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


    //第三种头部,经典 风格的头部实现,下拉箭头+时间
    PtrClassicDefaultHeader ptrClassicDefaultHeader = new PtrClassicDefaultHeader(this);
    ptrFrameLayout.setHeaderView(ptrClassicDefaultHeader);

    PtrClassicDefaultFooter ptrClassicDefaultFooter = new PtrClassicDefaultFooter(this);
    ptrFrameLayout.setFooterView(ptrClassicDefaultFooter);

    ptrFrameLayout.addPtrUIHandler(ptrClassicDefaultHeader);
    ptrFrameLayout.addPtrUIHandler(ptrClassicDefaultFooter);

如上面代码所示,Header,Footer的种类是一样的,Header有三种,Footer也有三种,定义好之后,通过 setHeaderView(), setFooterView() 添加到 ptrFrameLayout 中,然后通过调用 addPtrUIHandler 监听两者的状态即可。不监听会显示空白,看不到具体内容

第四步:监听刷新过程

ptrFrameLayout.setPtrHandler(new PtrDefaultHandler2() {
      @Override
      public void onLoadMoreBegin(PtrFrameLayout frame) {
        frame.postDelayed(ptrFrameLayout::refreshComplete, 2000);
      }

      @Override
      public void onRefreshBegin(PtrFrameLayout frame) {
        frame.postDelayed(ptrFrameLayout::refreshComplete, 2000);
      }
    });
    ptrFrameLayout.setMode(PtrFrameLayout.Mode.LOAD_MORE);

通过设置 setPtrHandler() 方法监听刷新过程。默认的是 PtrDefaultHandler2(),它是后来加的,包括刷新和加载。PtrDefaultHandler() 只包含刷新功能。通过setMode()方法设置:只要下拉刷新,或者只要上拉加载,或者两者都要。

    原文作者:海晨忆
    原文地址: https://www.jianshu.com/p/28bf6d38e0ea
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞