PullToRefreshListView



1 PullToRefreshListView的作用
目前,我们在使用很多应用的时候,都学会一个方法,那就是下拉刷新,不论是新闻类的APP界面,下拉刷新界面加载最新数据,上拉刷出列表加载界面;还是交友类APP,下拉刷新最新的数据;亦或是购物类APP下拉刷新最新商品推送。目前有太多的应用使用该种方法提升用户体验,在视频播放其中,我们利用下拉屏幕,就可以刷新最新视频库的资源推送给用户。当然,上面说的这些功能基本都是依靠PullToRefreshListView来完成的。
那么在程序中我们该如何实现下拉刷新。
1)首先需要定义变量mPullRefreshListView;
2)初始化mPullRefreshListView并设置监听器,以执行当需要刷新时代码如图1所示,对应代码为:
 
图1 初始化mPullRefreshListView并设置监听器
 
图2 设置监听刷新刷新调用代码
设置监听刷新时执行如下代码,调用setLastUpdatedLabelAndCompletRefresh方法,代码如图2所示。
如图3所示在PullToRefreshListView中有三个View,其中headerView一共有2个LoadingView,一个是被加入到LinearLayout,一个是被加入到ListView的HeaderView。

 
图3 HeaderView结构
addViewInternal方法就是加入到LinearLayout父类中看看LoadingLayout 有2种 FlipLoadingLayout 和 RotateLoadingLayout 一般我们用旋转的加载动画,左边一个旋转图片,右边是文字和时间提示第一个LoadingLayout主要显示:松开即可刷新(往下拉),下拉即可刷新(再往上划),第二个LoadingLayout显示松手后的文字:正在加载,加载完成之后显示:已更新。如上图所示结构。
     
图4 顶端拉动HeaderView显示
 
图5 顶端拉动HeaderView后刷新显示
2. PullToRefreshListView创建的流程
如下图6所示,在OnlineVideoHomepageFragment中,创建了PullToRefreshListView的实例。
 
图6 OnlineVideoHomepageFragment中使用PullToRefreshListView
下面将介绍在创建PullToRefreshListView的流程。如图7所示为创建PullToRefreshListView的流程。
 
图7 创建PullToRefreshListView的流程
1)首先创建PullToRefreshListView,调用了createRefreshableView(Context context, AttributeSet attrs)方法,在该方法中接着调用方法createListView(context, attrs)。
2)在createListView(context, attrs)中,创建InternalListView(context, attrs)的实例。
3)调用handleStyledAttributes(TypedArray a)方法,创建mHeaderLoadingView和mFooterLoadingView,并将setScrollingWhileRefreshingEnabled设置为true,即下滑后View设置为可滑动。
4)调用setFragmentLastUpdatedLabelAndCompletRefresh完成刷新。
5)最后调用onRefreshComplete(),也就是调用PullToRefreshBase中的setState(State.RESET)方法,设置状态。
加载“推介”界面,不进行上拉,在创建View需按上述步骤进行调用。
3. PullToRefreshListView调用其方法的时序
 
图8 PullToRefreshListView继承关系
整个下拉刷新父View是LinearLayout,在LinearLayout添加了Header View ,Footer View和ListView。PullToRefreshBase 是父类扩展了 LinearLayout水平布局如果我们使用ListView 需要观看子类PullToRefreshAdapterViewBase -> PullToRefreshListView。如图8所示为PullToRefreshListView继承关系。
在第一次上拉刷新界面时,调用onRefreshing,通过getCurrentMode()获取上拉为PULL_FROM_START,拉到顶端将执行switch的default中的程序。如果不是第一次拉动,在再次拉动前调用方法onReset()。如图9所示是PullToRefreshListView调用其方法的时序图。
 
图9 PullToRefreshListView调用其方法的时序图
4. PullToRefreshListView详解
(1)InternalListView类
该类的继承关系如下:
InternalListView->VelocityListView->AutoScrollListView->ListView
该类重写了dispatchDraw ()和dispatchTouchEvent()方法,对于dispatchTouchEvent详解如下。
当TouchEvent发生时,首先Activity将TouchEvent传递给最顶层的View, TouchEvent最先到达最顶层 view的 dispatchTouchEvent ,然后由  dispatchTouchEvent 方法进行分发,如果dispatchTouchEvent返回true ,则交给该View的onTouchEvent处理,如果dispatchTouchEvent返回 false ,则交给该View的 interceptTouchEvent 方法来决定是否要拦截这个事件,如果 interceptTouchEvent 返回 true ,也就是拦截掉了,则交给它的 onTouchEvent 来处理,如果 interceptTouchEvent 返回 false ,那么就传递给子 view ,由子 view 的 dispatchTouchEvent 再来开始这个事件的分发。如果事件传递到某一层的子 view 的 onTouchEvent 上了,这个方法返回了 false ,那么这个事件会从这个 view 往上传递,都是 onTouchEvent 来接收。而如果传递到最上面的 onTouchEvent 也返回 false 的话,这个事件就会“消失”,而且接收不到下一次事件。
(2)handleStyledAttributes方法
在该方法中,主要完成了创建mHeaderLayoutingView和mFooterLayoutingView。并在创建时进行隐藏,同时通过FrameLayout的addView方法加入View中。handleStyledAttributes方法定位到子类复写的地方:
FrameLayout frame = new FrameLayout(getContext());
mHeaderLoadingView = createLoadingLayout(getContext(), Mode.PULL_FROM_START, a);
mHeaderLoadingView.setVisibility(View.GONE);
frame.addView(mHeaderLoadingView, lp);
mRefreshableView.addHeaderView(frame, null, false);//添加LoadingView到ListView Header上
(3)PullToRefreshBase
这个类是PullToRefreshListView的一个核心的类,该类是一个泛型抽象类,ListView,GridView,ScrollView等都需要继承它。PullToRefreshBase本质上是一个LinearLayout。
PullToRefreshBase实际上包含了三个View,一个是头部要下拉刷新时候的mHeaderLayout,一个是要加载更多的mFooterLayout,还有一个就是mRefreshableView,这个是泛型,具体是ListView,还是GridView,获取其他View,需要看泛型T。
代码中,其实就是下面这三个View:
T mRefreshableView;
private LoadingLayout mHeaderLayout;
private LoadingLayout mFooterLayout;
1)init是类PullToRefreshBase构造方法的核心代码。分析init()方法。
进入init方法之后,会发现,它首先会判断,是上下拉刷新,还是左右拉刷新,左右拉的实现是PullToRefreshHorizontalScrollView,我们这里仅分析上下拉,它们的原理都是一样的。它会先设置一下布局的方向,是上下布局,还是左右布局,通过getPullToRefreshScrollDirection()来判断。就开始给三个View,创建对象并添加到PullToRefreshBase里面。
2)createRefreshableView是一个抽象方法,它需要实现它的子类来提供T这个对象,比如ListView实现了PullToRefreshBase,他们就由ListView来提供对象。这里,ListView就会返回一个ListView对象,于是,这个泛型T,就是ListView。createLoadingLayout负责创建mHeaderLayout和mFooterLayout。在init方法的最后面,有一个方法叫updateUIForMode(),这里面是隐藏mHeaderLayout和mFooterLayout进入方法updateUIForMode()。
3)最核心的是refreshLoadingViewsSize()于是,我们进入refreshLoadingViewsSize,看一下它是怎么隐藏头部和尾部的。它会根据方向,首先给头部和尾部设置宽高。然后调用setPadding(pLeft, pTop, pRight, pBottom)来隐藏头部和尾部。
4)手放到手机屏幕滑动的时候会有滑动事件,会在onTouchEvent里面去做处理,但是,要知道,PullToRefreshBase是一个LinearLayout,而该布局里面的三个View中,有一个是ListView(以下泛型T,都以ListView为例子),而ListView它也有onTouchEvent事件,那么PullToRefreshBase事件与ListView的事件,就发生了冲突。
5)PullToRefreshBase的事件分发:
View的事件分发会从最外层的ViewGroup往最内层的View来分发,会走dispatchTouchEvent,onInterceptTouchEvent,onTouchEvent,如果ViewGroup在onInterceptTouchEvent 返回true,则表示要拦截事件,那么被拦截的时间就由当前的ViewGroup的onTouchEvent进行处理。PullToRefreshBase 是一个LinearLayout,LinearLayout也是一个ViewGroup。PullToRefreshBase是在onInterceptTouchEvent进行事件拦截。在代码中有一个方法,叫isReadyForPull(),在MotionEvent.ACTION_MOVE的时候,如果这个方法返回true,mIsBeingDragged也就返回true,于是,就拦截了事件,不把事件分发到ListView里面去,从而使PullToRefreshBase的onTouch来处理改事件,PullToRefreshBase的onTouch就来对下拉或者上拉滑动事件进行处理。
isReadyForPull会根据Mode来判断是上拉,还是下拉,如果是下拉。就调用isReadyForPullStart()来判断,如果是上拉就调用isReadyForPullEnd(),如果Mode是BOTH就两者都调用。
如果当前显示的是ListView的最后一个Item,那么,就拦截ListView的上拉事件,让上拉事件给PullToRefreshBase来处理。而ListView只做下拉的滚动。
此时,我们知道了ListView也就是PullToRefreshListView和PullToRefreshBase对事件拦截和分发的处理过程。
(4)onRefreshing
拉倒最顶部松手,会执行onRefreshing方法,回调实现的任务接口也就是callRefreshListener。如图10所示为onRefreshing方法中switch对应的代码。
 
图10 onRefreshing方法switch对应的代码
对于onRefreshing中获取触屏状态是通过getCurrentMode()获取的,当除pull_from_end外都将执行刷新程序。顶部上拉对应pull_from_start,接着也将执行default。
 
图11 Mode对应的参数代码
如图11所示为Mode对应的参数代码,其意义见下:
PULL_FROM_START:仅仅支持下动刷新;
PULL_FROM_END:仅支持上拉加载更多;
BOTH:上拉下拉都支持;
MANUAL_REFRESH_ONLY:只允许手动触发。

1 PullToRefreshListView的作用
目前,我们在使用很多应用的时候,都学会一个方法,那就是下拉刷新,不论是新闻类的APP界面,下拉刷新界面加载最新数据,上拉刷出列表加载界面;还是交友类APP,下拉刷新最新的数据;亦或是购物类APP下拉刷新最新商品推送。目前有太多的应用使用该种方法提升用户体验,在视频播放其中,我们利用下拉屏幕,就可以刷新最新视频库的资源推送给用户。当然,上面说的这些功能基本都是依靠PullToRefreshListView来完成的。
那么在程序中我们该如何实现下拉刷新。
1)首先需要定义变量mPullRefreshListView;
2)初始化mPullRefreshListView并设置监听器,以执行当需要刷新时代码如图1所示,对应代码为:

图1 初始化mPullRefreshListView并设置监听器

图2 设置监听刷新刷新调用代码
设置监听刷新时执行如下代码,调用setLastUpdatedLabelAndCompletRefresh方法,代码如图2所示。
如图3所示在PullToRefreshListView中有三个View,其中headerView一共有2个LoadingView,一个是被加入到LinearLayout,一个是被加入到ListView的HeaderView。


图3 HeaderView结构
addViewInternal方法就是加入到LinearLayout父类中看看LoadingLayout 有2种 FlipLoadingLayout 和 RotateLoadingLayout 一般我们用旋转的加载动画,左边一个旋转图片,右边是文字和时间提示第一个LoadingLayout主要显示:松开即可刷新(往下拉),下拉即可刷新(再往上划),第二个LoadingLayout显示松手后的文字:正在加载,加载完成之后显示:已更新。如上图所示结构。

图4 顶端拉动HeaderView显示

图5 顶端拉动HeaderView后刷新显示
2. PullToRefreshListView创建的流程
如下图6所示,在OnlineVideoHomepageFragment中,创建了PullToRefreshListView的实例。

图6 OnlineVideoHomepageFragment中使用PullToRefreshListView
下面将介绍在创建PullToRefreshListView的流程。如图7所示为创建PullToRefreshListView的流程。

图7 创建PullToRefreshListView的流程
1)首先创建PullToRefreshListView,调用了createRefreshableView(Context context, AttributeSet attrs)方法,在该方法中接着调用方法createListView(context, attrs)。
2)在createListView(context, attrs)中,创建InternalListView(context, attrs)的实例。
3)调用handleStyledAttributes(TypedArray a)方法,创建mHeaderLoadingView和mFooterLoadingView,并将setScrollingWhileRefreshingEnabled设置为true,即下滑后View设置为可滑动。
4)调用setFragmentLastUpdatedLabelAndCompletRefresh完成刷新。
5)最后调用onRefreshComplete(),也就是调用PullToRefreshBase中的setState(State.RESET)方法,设置状态。
加载“推介”界面,不进行上拉,在创建View需按上述步骤进行调用。
3. PullToRefreshListView调用其方法的时序

图8 PullToRefreshListView继承关系
整个下拉刷新父View是LinearLayout,在LinearLayout添加了Header View ,Footer View和ListView。PullToRefreshBase 是父类扩展了 LinearLayout水平布局如果我们使用ListView 需要观看子类PullToRefreshAdapterViewBase -> PullToRefreshListView。如图8所示为PullToRefreshListView继承关系。
在第一次上拉刷新界面时,调用onRefreshing,通过getCurrentMode()获取上拉为PULL_FROM_START,拉到顶端将执行switch的default中的程序。如果不是第一次拉动,在再次拉动前调用方法onReset()。如图9所示是PullToRefreshListView调用其方法的时序图。

图9 PullToRefreshListView调用其方法的时序图
4. PullToRefreshListView详解
(1)InternalListView类
该类的继承关系如下:
InternalListView->VelocityListView->AutoScrollListView->ListView
该类重写了dispatchDraw ()和dispatchTouchEvent()方法,对于dispatchTouchEvent详解如下。
当TouchEvent发生时,首先Activity将TouchEvent传递给最顶层的View, TouchEvent最先到达最顶层 view的 dispatchTouchEvent ,然后由 dispatchTouchEvent 方法进行分发,如果dispatchTouchEvent返回true ,则交给该View的onTouchEvent处理,如果dispatchTouchEvent返回 false ,则交给该View的 interceptTouchEvent 方法来决定是否要拦截这个事件,如果 interceptTouchEvent 返回 true ,也就是拦截掉了,则交给它的 onTouchEvent 来处理,如果 interceptTouchEvent 返回 false ,那么就传递给子 view ,由子 view 的 dispatchTouchEvent 再来开始这个事件的分发。如果事件传递到某一层的子 view 的 onTouchEvent 上了,这个方法返回了 false ,那么这个事件会从这个 view 往上传递,都是 onTouchEvent 来接收。而如果传递到最上面的 onTouchEvent 也返回 false 的话,这个事件就会“消失”,而且接收不到下一次事件。
(2)handleStyledAttributes方法
在该方法中,主要完成了创建mHeaderLayoutingView和mFooterLayoutingView。并在创建时进行隐藏,同时通过FrameLayout的addView方法加入View中。handleStyledAttributes方法定位到子类复写的地方:
FrameLayout frame = new FrameLayout(getContext());
mHeaderLoadingView = createLoadingLayout(getContext(), Mode.PULL_FROM_START, a);
mHeaderLoadingView.setVisibility(View.GONE);
frame.addView(mHeaderLoadingView, lp);
mRefreshableView.addHeaderView(frame, null, false);//添加LoadingView到ListView Header上
(3)PullToRefreshBase
这个类是PullToRefreshListView的一个核心的类,该类是一个泛型抽象类,ListView,GridView,ScrollView等都需要继承它。PullToRefreshBase本质上是一个LinearLayout。
PullToRefreshBase实际上包含了三个View,一个是头部要下拉刷新时候的mHeaderLayout,一个是要加载更多的mFooterLayout,还有一个就是mRefreshableView,这个是泛型,具体是ListView,还是GridView,获取其他View,需要看泛型T。
代码中,其实就是下面这三个View:
T mRefreshableView;
private LoadingLayout mHeaderLayout;
private LoadingLayout mFooterLayout;
1)init是类PullToRefreshBase构造方法的核心代码。分析init()方法。
进入init方法之后,会发现,它首先会判断,是上下拉刷新,还是左右拉刷新,左右拉的实现是PullToRefreshHorizontalScrollView,我们这里仅分析上下拉,它们的原理都是一样的。它会先设置一下布局的方向,是上下布局,还是左右布局,通过getPullToRefreshScrollDirection()来判断。就开始给三个View,创建对象并添加到PullToRefreshBase里面。
2)createRefreshableView是一个抽象方法,它需要实现它的子类来提供T这个对象,比如ListView实现了PullToRefreshBase,他们就由ListView来提供对象。这里,ListView就会返回一个ListView对象,于是,这个泛型T,就是ListView。createLoadingLayout负责创建mHeaderLayout和mFooterLayout。在init方法的最后面,有一个方法叫updateUIForMode(),这里面是隐藏mHeaderLayout和mFooterLayout进入方法updateUIForMode()。
3)最核心的是refreshLoadingViewsSize()于是,我们进入refreshLoadingViewsSize,看一下它是怎么隐藏头部和尾部的。它会根据方向,首先给头部和尾部设置宽高。然后调用setPadding(pLeft, pTop, pRight, pBottom)来隐藏头部和尾部。
4)手放到手机屏幕滑动的时候会有滑动事件,会在onTouchEvent里面去做处理,但是,要知道,PullToRefreshBase是一个LinearLayout,而该布局里面的三个View中,有一个是ListView(以下泛型T,都以ListView为例子),而ListView它也有onTouchEvent事件,那么PullToRefreshBase事件与ListView的事件,就发生了冲突。
5)PullToRefreshBase的事件分发:
View的事件分发会从最外层的ViewGroup往最内层的View来分发,会走dispatchTouchEvent,onInterceptTouchEvent,onTouchEvent,如果ViewGroup在onInterceptTouchEvent 返回true,则表示要拦截事件,那么被拦截的时间就由当前的ViewGroup的onTouchEvent进行处理。PullToRefreshBase 是一个LinearLayout,LinearLayout也是一个ViewGroup。PullToRefreshBase是在onInterceptTouchEvent进行事件拦截。在代码中有一个方法,叫isReadyForPull(),在MotionEvent.ACTION_MOVE的时候,如果这个方法返回true,mIsBeingDragged也就返回true,于是,就拦截了事件,不把事件分发到ListView里面去,从而使PullToRefreshBase的onTouch来处理改事件,PullToRefreshBase的onTouch就来对下拉或者上拉滑动事件进行处理。
isReadyForPull会根据Mode来判断是上拉,还是下拉,如果是下拉。就调用isReadyForPullStart()来判断,如果是上拉就调用isReadyForPullEnd(),如果Mode是BOTH就两者都调用。
如果当前显示的是ListView的最后一个Item,那么,就拦截ListView的上拉事件,让上拉事件给PullToRefreshBase来处理。而ListView只做下拉的滚动。
此时,我们知道了ListView也就是PullToRefreshListView和PullToRefreshBase对事件拦截和分发的处理过程。
(4)onRefreshing
拉倒最顶部松手,会执行onRefreshing方法,回调实现的任务接口也就是callRefreshListener。如图10所示为onRefreshing方法中switch对应的代码。

图10 onRefreshing方法switch对应的代码
对于onRefreshing中获取触屏状态是通过getCurrentMode()获取的,当除pull_from_end外都将执行刷新程序。顶部上拉对应pull_from_start,接着也将执行default。

图11 Mode对应的参数代码
如图11所示为Mode对应的参数代码,其意义见下:
PULL_FROM_START:仅仅支持下动刷新;
PULL_FROM_END:仅支持上拉加载更多;
BOTH:上拉下拉都支持;
MANUAL_REFRESH_ONLY:只允许手动触发。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值