个人博客: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。步骤:
xml里面定义控件PtrFrameLayout
设置相关属性
添加Header,Footer,并监听
监听刷新过程
第一步: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代码里面设置,相关属性含义如下:
Resistence:阻尼系数,可以分别设置header和footer。默认: 1.7f,越大,感觉下拉刷新时越吃力。上拉加载也是一样的
Ratio of the Height of the Header to Refresh:触发刷新时移动的位置比例。
默认,1.2f,移动达到头部高度1.2倍时可触发刷新操作。下拉刷新,上拉加载都一样。Duration to Close back:回弹延时。默认 200ms,回弹到刷新或者高度所用时间,可以跟上面一样分开设置,也可以设置一个
Duration to Close Header:刷新完成之后隐藏头部的时间。默认1000mscube_ptr:ptr_duration_to_close_either=”2000″
Keep Header while Refreshing:刷新是保持头部,也就是显示头部。默认值 true。false:隐藏头部
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()方法设置:只要下拉刷新,或者只要上拉加载,或者两者都要。