Android打造(ListView、GridView等)通用的下拉刷新、上拉自动加载的组件

来源:互联网 发布:手机版java通用版 编辑:程序博客网 时间:2024/05/24 03:15

前言

      下拉刷新组件在开发中使用率是非常高的,基本上联网的APP都会采用这种方式。对于开发效率而言,使用获得大家认可的开源库必然是效率最高的,但是不重复发明轮子的前提是你得自己知道轮子是怎么发明出来的,并且自己能够实现这些功能。否则只是知道其原理,并没有去实践那也就是纸上谈兵了。做程序猿,动手做才会遇到真正的问题,否则就只是自以为是的认为自己懂了。今天这篇文章就是以自己重复发明轮子这个出发点而来的,通过实现经典、使用率较高的组件来提高自己的认识。下面我们就一起来学习吧。

整体布局结构

                                          

图1  图2

    该组件整体以竖直方向的LinearLayout为根视图,分别是Header、ContentView、Foooter, 从上到下依次排列下来,其中ContentView的宽高都为match_parent,footer和header的宽、高分别为match_parent、wrap_content,原始效果如图1;在Header、Foooter初始时都会通过设置padding隐藏掉,如图2中的Header设置paddingTop为负的Header的高度值,同理Footer也通过设置paddingBottom为Footer的负的Footer高度来达到隐藏的效果,所以只有 ContentView区域显示出来。当用户下拉到顶端,并且继续下拉时触发下拉刷新操作;当用户上拉到底部, 并且继续上拉时触发加载更多的操作。

    原理都虽然简单,但是实现起来却也是会有很多小麻烦。这里没有采用通过设置onTouchListener的方法,因此使用这个方式在下拉的时候依然会出现ListView的最顶部的"HOLD"视图,不太爽。这种实现方法也蛮简单的,具体看郭神的博客Android下拉刷新完全解析,教你如何一分钟实现下拉刷新功能。

下拉刷新基本原理

      基本原理就是在用户滑动屏幕上的组件时,在onInterceptTouchEvent方法中判断是否到了ContentView (这里我们以ListView为例来说明)的最顶端,如果到了最顶端且用户还继续向下滑,那么会拦截触摸事件避免它分发到ListView,即在onInterceptTouchEvent中返回true ( 不太清楚的可以参考资料如下 : Android Touch事件分发过程。 ),这样就将触摸事件分发到了onTouchEvent函数中,我们对于用户触摸事件的处理逻辑主要都在这个函数中。如果该函数返回false,那么触摸事件则会分发给其Child View,这里的这个Child View就是ListView了,当返回false时用户滑动屏幕时就会滚动ListView。
[java] view plaincopyprint?在CODE上查看代码片派生到我的代码片
  1. /* 
  2.  * 在适当的时候拦截触摸事件,这里指的适当的时候是当mContentView滑动到顶部,并且是下拉时拦截触摸事件,否则不拦截,交给其child 
  3.  * view 来处理。 
  4.  * @see 
  5.  * android.view.ViewGroup#onInterceptTouchEvent(android.view.MotionEvent) 
  6.  */  
  7. @Override  
  8. public boolean onInterceptTouchEvent(MotionEvent ev) {  
  9.   
  10.     /* 
  11.      * This method JUST determines whether we want to intercept the motion. 
  12.      * If we return true, onTouchEvent will be called and we do the actual 
  13.      * scrolling there. 
  14.      */  
  15.     final int action = MotionEventCompat.getActionMasked(ev);  
  16.     // Always handle the case of the touch gesture being complete.  
  17.     if (action == MotionEvent.ACTION_CANCEL || action == MotionEvent.ACTION_UP) {  
  18.         // Do not intercept touch event, let the child handle it  
  19.         return false;  
  20.     }  
  21.   
  22.     switch (action) {  
  23.   
  24.         case MotionEvent.ACTION_DOWN:  
  25.             mYDown = (int) ev.getRawY();  
  26.             break;  
  27.   
  28.         case MotionEvent.ACTION_MOVE:  
  29.             // int yDistance = (int) ev.getRawY() - mYDown;  
  30.             mYDistance = (int) ev.getRawY() - mYDown;  
  31.             showStatus(mCurrentStatus);  
  32.             Log.d(VIEW_LOG_TAG, "%%% isBottom : " + isBottom() + ", isTop : " + isTop()  
  33.                     + ", mYDistance : " + mYDistance);  
  34.             // 如果拉到了顶部, 并且是下拉,则拦截触摸事件,从而转到onTouchEvent来处理下拉刷新事件  
  35.             if ((isTop() && mYDistance > 0)  
  36.                     || (mYDistance > 0 && mCurrentStatus == STATUS_REFRESHING)) {  
  37.                 return true;  
  38.             }  
  39.             break;  
  40.   
  41.     }  
  42.   
  43.     // Do not intercept touch event, let the child handle it  
  44.     return false;  
  45. }  
     首先我们在ACTION_DOWN事件中记录用户按下的触摸点的Y轴坐标mYDown,然后在ACTION_MOVE中再次获取Y轴的坐标,计算出两者之间的差值。如果滑动的差值大于mTouchSlop则继续进行处理,mTouchSlop为判断一个触摸滑动事件是否有效的的最小阀值,如果小于这个阀值我们认为这个触摸滑动事件无效,例如手抖了一下,距离很短,因此我们忽略类似的事件。
      在有效的滑动距离之内,我们判断当前组件的状态,如果不是正在刷新的状态,那么我们根据当前ListView的paddingTop的高度来设置不同的值,paddingTop如果高度大于ListView高度的70%,那么我们将当前状态设置为“释放可刷新”状态,即STATUS_RELEASE_TO_REFRESH状态;反之,我们设置状态为“继续下拉”状态,即“STATUS_PULL_TO_REFRESH”。通过这个paddingTop高度我们来规定当用户下拉距离到一定的距离后才出发刷新操作,否则视为无效下拉。然而不管这个时候是什么状态,我们都会修改Header的padding Top属性,从而达到拉伸header的效果。
     当状态为“释放可刷新”时,我们抬起手指,会出发ACTION_UP事件,此时我们在该事件中进行下拉刷新操作。onTouchEvent代码如下 :
[java] view plaincopyprint?在CODE上查看代码片派生到我的代码片
  1. /* 
  2.  * 在这里处理触摸事件以达到下拉刷新或者上拉自动加载的问题 
  3.  * @see android.view.View#onTouchEvent(android.view.MotionEvent) 
  4.  */  
  5. @Override  
  6. public boolean onTouchEvent(MotionEvent event) {  
  7.   
  8.     Log.d(VIEW_LOG_TAG, "@@@ onTouchEvent : action = " + event.getAction());  
  9.     switch (event.getAction()) {  
  10.         case MotionEvent.ACTION_DOWN:  
  11.             mYDown = (int) event.getRawY();  
  12.             Log.d(VIEW_LOG_TAG, "#### ACTION_DOWN");  
  13.             break;  
  14.   
  15.         case MotionEvent.ACTION_MOVE:  
  16.             Log.d(VIEW_LOG_TAG, "#### ACTION_MOVE");  
  17.             int currentY = (int) event.getRawY();  
  18.             mYDistance = currentY - mYDown;  
  19.             // 高度大于header view的高度才可以刷新  
  20.             if (mYDistance >= mTouchSlop) {  
  21.                 if (mCurrentStatus != STATUS_REFRESHING) {  
  22.                     //   
  23.                     if (mHeaderView.getPaddingTop() > mHeaderViewHeight * 0.7f) {  
  24.                         mCurrentStatus = STATUS_RELEASE_TO_REFRESH;  
  25.                         mTipsTextView.setText(R.string.pull_to_refresh_release_label);  
  26.                     } else {  
  27.                         mCurrentStatus = STATUS_PULL_TO_REFRESH;  
  28.                         mTipsTextView.setText(R.string.pull_to_refresh_pull_label);  
  29.                     }  
  30.                 }  
  31.   
  32.                 rotateHeaderArrow();  
  33.                 int scaleHeight = (int) (mYDistance * 0.8f);// 去了滑动距离的80%,减小灵敏度而已  
  34.                 // Y轴的滑动距离小于屏幕高度4分之一时才会拉伸header,反之保持不变  
  35.                 if (scaleHeight <= mScrHeight / 4) {  
  36.                     adjustHeaderPadding(scaleHeight);  
  37.                 }  
  38.             }  
  39.   
  40.             break;  
  41.   
  42.         case MotionEvent.ACTION_UP:  
  43.             // 下拉刷新的具体操作   
  44.             doRefresh();  
  45.             break;  
  46.         default:  
  47.             break;  
  48.   
  49.     }  
  50.     return true;  
  51. }  
抬起手指时出发的刷新操作,代码如下:
[java] view plaincopyprint?在CODE上查看代码片派生到我的代码片
  1. /** 
  2.  * 执行刷新操作 
  3.  */  
  4. private final void doRefresh() {  
  5.     if (mCurrentStatus == STATUS_RELEASE_TO_REFRESH) {  
  6.         // 设置状态为正在刷新状态   
  7.         mCurrentStatus = STATUS_REFRESHING;  
  8.         mArrowImageView.clearAnimation();  
  9.         // 隐藏header中的箭头图标   
  10.         mArrowImageView.setVisibility(View.GONE);  
  11.         // 设置header中的进度条可见   
  12.         mHeaderProgressBar.setVisibility(View.VISIBLE);  
  13.         // 设置一些文本   
  14.         mTimeTextView.setText(R.string.pull_to_refresh_update_time_label);  
  15.         SimpleDateFormat sdf = new SimpleDateFormat();  
  16.         mTimeTextView.append(sdf.format(new Date()));  
  17.         //   
  18.         mTipsTextView.setText(R.string.pull_to_refresh_refreshing_label);  
  19.   
  20.         // 执行回调   
  21.         if (mPullRefreshListener != null) {  
  22.             mPullRefreshListener.onRefresh();  
  23.         }  
  24.         // 使headview 正常显示, 直到调用了refreshComplete后再隐藏  
  25.         new HeaderViewHideTask().execute(0);  
  26.   
  27.     } else {  
  28.         // 隐藏header view   
  29.         adjustHeaderPadding(-mHeaderViewHeight);  
  30.     }  
  31. }  
在刷新状态时,header正常显示,即此时的padding top需要设置为0,我们使用一个异步任务来逐步修改padding top的值,使得header从拉伸效果逐步、平滑的恢复原始的大小。用户调用refreshComplete()函数后,即刷新完成后,再逐步调整listview的padding top将其隐藏。至此,整个下拉刷新过程结束。

滑动到底部自动加载

    滑动到底部自动加载相对来说要简单得多,我们也是以ContentView是ListView的情况来说明。原理就是监听ListView ( 即 ContentView )的的滚动事件,因此如果ContentView的类型不支持滚动事件,则不能实现该功能。listview符合要求,因此其能实现自动加载。我们在onScroll函数中判断listview是否到了最后一项,如果到了最后一项,那么显示出footer,并且开始加载。当用户调用loadMoreComplete函数时代表加载结束。此时隐藏footer,整个过程结束。
    
[java] view plaincopyprint?在CODE上查看代码片派生到我的代码片
  1. /* 
  2.  * 滚动事件,实现滑动到底部时上拉加载更多 
  3.  * @see android.widget.AbsListView.OnScrollListener#onScroll(android.widget. 
  4.  * AbsListView, int, int, int) 
  5.  */  
  6. @Override  
  7. public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount,  
  8.         int totalItemCount) {  
  9.   
  10.     Log.d(VIEW_LOG_TAG, "&&& mYDistance = " + mYDistance);  
  11.     if (mFooterView == null || mYDistance >= 0 || mCurrentStatus == STATUS_LOADING  
  12.             || mCurrentStatus == STATUS_REFRESHING) {  
  13.         return;  
  14.     }  
  15.   
  16.     loadmore();  
  17. }  
  18.   
  19. /** 
  20.  * 下拉到底部时加载更多 
  21.  */  
  22. private void loadmore() {  
  23.     if (isShowFooterView() && mLoadMoreListener != null) {  
  24.         mFooterTextView.setText(R.string.pull_to_refresh_refreshing_label);  
  25.         mFooterProgressBar.setVisibility(View.VISIBLE);  
  26.         adjustFooterPadding(0);  
  27.         mCurrentStatus = STATUS_LOADING;  
  28.         mLoadMoreListener.onLoadMore();  
  29.     }  
  30. }  
其中loadmore函数中调用的isShowFooterView函数就是用来判断是否到了最底部的,代码如下 : 
[java] view plaincopyprint?在CODE上查看代码片派生到我的代码片
  1. /* 
  2.     * 下拉到listview 最后一项时则返回true, 将出发自动加载 
  3.     * @see com.uit.pullrefresh.base.PullRefreshBase#isShowFooterView() 
  4.     */  
  5.    @Override  
  6.    protected boolean isShowFooterView() {  
  7.        if (mContentView == null || mContentView.getAdapter() == null) {  
  8.            return false;  
  9.        }  
  10.   
  11.        return mContentView.getLastVisiblePosition() == mContentView.getAdapter().getCount() - 1;  
  12.    }  
OK,至此整个核心的过程介绍完毕了。

效果图

ListView



TextView下拉刷新


github地址

猛击这里!

0 0
原创粉丝点击