[置顶]Android 下拉刷新框架实现

分类：Android设计 2013-10-13 23:20 5089人阅读 评论(67) 收藏 举报 下拉刷新 pulltorefresh android

目录(?)[+]

前段时间项目中用到了下拉刷新功能，之前在网上也找到过类似的demo，但这些demo的质量参差不齐，用户体验也不好，接口设计也不行。最张没办法，终于忍不了了，自己就写了一个下拉刷新的框架，这个框架是一个通用的框架，效果和设计感觉都还不错，现在分享给各位看官。

致谢：

1. 感谢lk6233160同学提出的问题，旋转View时调用setRotation方法只能是在API Level11（3.0）以上才能用，这个问题的解决办法是给ImageView设置一个Matrix，把Matrix上面作用一个旋转矩阵，但是如果不是ImageView的话，可能实现起来比较麻烦，再次谢谢lk6233160同学。

2. 谢谢如毛毛风提出的问题，向下滑动后，再向上滑动到头，只能再松手后才能再次下拉。这个问题的回复请参考评论。

技术交流群：

QQ：197990971


1. 关于下拉刷新

下拉刷新这种用户交互最早由twitter创始人洛伦•布里切特(Loren Brichter)发明， 有理论认为，下拉刷新是一种适用于按照从新到旧的时间顺序排列feeds的应用，在这种应用场景中看完旧的内容时，用户会很自然地下拉查找更新的内容，因此下拉刷新就显得非常合理。大家可以参考这篇文章： 有趣的下拉刷新，下面我贴出一个有趣的下拉刷新的案例。 Android 下拉刷新框架实现_第1张图片
图一、有趣的下拉刷新案例（一）
Android 下拉刷新框架实现_第2张图片
图一、有趣的下拉刷新案例（二）


2. 实现原理

上面这些例子，外观做得再好看，他的本质上都一样，那就是一个下拉刷新控件通常由以下几部分组成： 【1】Header Header通常有下拉箭头，文字，进度条等元素，根据下拉的距离来改变它的状态，从而显示不同的样式 【2】Content 这部分是内容区域，网上有很多例子都是直接在ListView里面添加Header，但这就有局限性，因为好多情况下并不一定是用ListView来显示数据。我们把要显示内容的View放置在我们的一个容器中，如果你想实现一个用ListView显示数据的下拉刷新，你需要创建一个ListView旋转到我的容器中。我们处理这个容器的事件（down, move, up），如果向下拉，则把整个布局向下滑动，从而把header显示出来。 【3】Footer Footer可以用来显示向上拉的箭头，自动加载更多的进度条等。
以上三部分总结的说来，就是如下图所示的这种布局结构： Android 下拉刷新框架实现_第3张图片 图三，下拉刷新的布局结构
关于上图，需要说明几点： 1、这个布局扩展于 LinearLayout，垂直排列 2、从上到下的顺序是：Header, Content, Footer 3、Content填充满父控件，通过设置top, bottom的padding来使Header和Footer不可见，也就是让它超出屏幕外 4、下拉时，调用scrollTo方法来将整个布局向下滑动，从而把Header显示出来，上拉正好与下拉相反。 5、派生类需要实现的是：将Content View填充到父容器中，比如，如果你要使用的话，那么你需要把ListView, ScrollView, WebView等添加到容器中。 6、上图中的红色区域就是屏的大小（严格来说，这里说屏幕大小并不准确，应该说成内容区域更加准确）

3. 具体实现

明白了实现原理与过程，我们尝试来具体实现，首先，为了以后更好地扩展，设计更加合理，我们把下拉刷新的功能抽象成一个接口：

1、IPullToRefresh<T extends View>

它具体的定义方法如下： [java] view plain copy
  1. publicinterfaceIPullToRefresh<TextendsView>{
  2. publicvoidsetPullRefreshEnabled(booleanpullRefreshEnabled);
  3. publicvoidsetPullLoadEnabled(booleanpullLoadEnabled);
  4. publicvoidsetScrollLoadEnabled(booleanscrollLoadEnabled);
  5. publicbooleanisPullRefreshEnabled();
  6. publicbooleanisPullLoadEnabled();
  7. publicbooleanisScrollLoadEnabled();
  8. publicvoidsetOnRefreshListener(OnRefreshListener<T>refreshListener);
  9. publicvoidonPullDownRefreshComplete();
  10. publicvoidonPullUpRefreshComplete();
  11. publicTgetRefreshableView();
  12. publicLoadingLayoutgetHeaderLoadingLayout();
  13. publicLoadingLayoutgetFooterLoadingLayout();
  14. publicvoidsetLastUpdatedLabel(CharSequencelabel);
  15. }
这个接口是一个泛型的，它接受View的派生类， 因为要放到我们的容器中的不就是一个View吗？
2、PullToRefreshBase<T extends View> 这个类实现了IPullToRefresh接口，它是从LinearLayout继承过来，作为下拉刷新的一个 抽象基类，如果你想实现ListView的下拉刷新，只需要扩展这个类，实现一些必要的方法就可以了。这个类的职责主要有以下几点：
  • 处理onInterceptTouchEvent()和onTouchEvent()中的事件：当内容的View（比如ListView）正如处于最顶部，此时再向下拉，我们必须截断事件，然后move事件就会把后续的事件传递到onTouchEvent()方法中，然后再在这个方法中，我们根据move的距离再进行scroll整个View。
  • 负责创建Header、Footer和Content View：在构造方法中调用方法去创建这三个部分的View，派生类可以重写这些方法，以提供不同式样的Header和Footer，它会调用createHeaderLoadingLayout和createFooterLoadingLayout方法来创建Header和Footer创建Content View的方法是一个抽象方法，必须让派生类来实现，返回一个非null的View，然后容器再把这个View添加到自己里面。
  • 设置各种状态：这里面有很多状态，如下拉、上拉、刷新、加载中、释放等，它会根据用户拉动的距离来更改状态，状态的改变，它也会把Header和Footer的状态改变，然后Header和Footer会根据状态去显示相应的界面式样。
3、PullToRefreshBase<T extends View>继承关系 这里我实现了三个下拉刷新的派生类，分别是ListView、ScrollView、WebView三个，它们的继承关系如下： Android 下拉刷新框架实现_第4张图片
图四、PullToRefreshBase类的继承关系
关于PullToRefreshBase类及其派和类，有几点需要说明：
  • 对于ListView，ScrollView，WebView这三种情况，他们是否滑动到最顶部或是最底部的实现是不一样的，所以，在PullToRefreshBase类中需要调用两个抽象方法来判断当前的位置是否在顶部或底部，而其派生类必须要实现这两个方法。比如对于ListView，它滑动到最顶部的条件就是第一个child完全可见并且first postion是0。这两个抽象方法是：
[java] view plain copy
  1. /**
  2. *判断刷新的View是否滑动到顶部
  3. *
  4. *@returntrue表示已经滑动到顶部，否则false
  5. */
  6. protectedabstractbooleanisReadyForPullDown();
  8. /**
  9. *判断刷新的View是否滑动到底
  10. *
  11. *@returntrue表示已经滑动到底部，否则false
  12. */
  13. protectedabstractbooleanisReadyForPullUp();
  • 创建可下拉刷新的View（也就是content view）的抽象方法是
[java] view plain copy
  1. /**
  2. *创建可以刷新的View
  3. *
  4. *@paramcontextcontext
  5. *@paramattrs属性
  6. *@returnView
  7. */
  8. protectedabstractTcreateRefreshableView(Contextcontext,AttributeSetattrs);
4、LoadingLayout LoadingLayout是刷新Layout的一个抽象，它是一个抽象基类。Header和Footer都扩展于这个类。这类抽象类，提供了两个抽象方法：
  • getContentSize
这个方法返回当前这个刷新Layout的大小，通常返回的是布局的高度，为了以后可以扩展为水平拉动，所以方法名字没有取成getLayoutHeight()之类的，这个返回值，将会作为松手后是否可以刷新的临界值，如果下拉的偏移值大于这个值，就认为可以刷新，否则不刷新，这个方法必须由派生类来实现。
  • setState
这个方法用来设置当前刷新Layout的状态，PullToRefreshBase类会调用这个方法，当进入下拉，松手等动作时，都会调用这个方法，派生类里面只需要根据这些状态实现不同的界面显示，如下拉状态时，就显示出箭头，刷新状态时，就显示loading的图标。 可能的状态值有： RESET, PULL_TO_REFRESH, RELEASE_TO_REFRESH, REFRESHING, NO_MORE_DATA

LoadingLayout及其派生类的继承关系如下图所示：
Android 下拉刷新框架实现_第5张图片
图五、LoadingLayout及其派生类的类图
我们可以随意地制定自己的Header和Footer，我们也可以实现如图一和图二中显示的各种下拉刷新案例中的Header和Footer，只要重写上述两个方法getContentSize()和setState()就行了。HeaderLoadingLayout，它默认是显示箭头式样的布局，而RotateLoadingLayout则是显示一个旋转图标的式样。
5、事件处理 我们必须重写PullToRefreshBase类的两个事件相关的方法 onInterceptTouchEvent()和onTouchEvent()方法。由于ListView，ScrollView，WebView它们是放到PullToRefreshBase内部的，所在事件先是传递到PullToRefreshBase#onInterceptTouchEvent()方法中，所以我们应该在这个方法中去处理ACTION_MOVE事件，判断如果当前ListView，ScrollView，WebView是否在最顶部或最底部，如果是，则开始截断事件，一旦事件被截断，后续的事件就会传递到PullToRefreshBase#onInterceptTouchEvent()方法中，我们再在ACTION_MOVE事件中去移动整个布局，从而实现下拉或上拉动作。
6、滚动布局(scrollTo) 如图三的布局结构可知，默认情况下Header和Footer是放置在Content View的最上面和最下面，通过设置padding来让他跑到屏幕外面去了，如果我们将整个布局向下滚动(scrollTo)一定距离，那么Header就会被显示出来，基于这种情况，所以在我的实现中，最终我是调用 scrollTo来实现下拉动作的。
总的说来，实现的重要的点就这些，具体的一些细节在实现在会碰到很多，可以参考代码。

4. 如何使用

使用下拉刷新的代码如下 [java] view plain copy
  1. @Override
  2. publicvoidonCreate(BundlesavedInstanceState){
  3. super.onCreate(savedInstanceState);
  5. mPullListView=newPullToRefreshListView(this);
  6. setContentView(mPullListView);
  8. //上拉加载不可用
  9. mPullListView.setPullLoadEnabled(false);
  10. //滚动到底自动加载可用
  11. mPullListView.setScrollLoadEnabled(true);
  13. mCurIndex=mLoadDataCount;
  14. mListItems=newLinkedList<String>();
  15. mListItems.addAll(Arrays.asList(mStrings).subList(0,mCurIndex));
  16. mAdapter=newArrayAdapter<String>(this,android.R.layout.simple_list_item_1,mListItems);
  18. //得到实际的ListView
  19. mListView=mPullListView.getRefreshableView();
  20. //绑定数据
  21. mListView.setAdapter(mAdapter);
  22. //设置下拉刷新的listener
  23. mPullListView.setOnRefreshListener(newOnRefreshListener<ListView>(){
  24. @Override
  25. publicvoidonPullDownToRefresh(PullToRefreshBase<ListView>refreshView){
  26. mIsStart=true;
  27. newGetDataTask().execute();
  28. }
  30. @Override
  31. publicvoidonPullUpToRefresh(PullToRefreshBase<ListView>refreshView){
  32. mIsStart=false;
  33. newGetDataTask().execute();
  34. }
  35. });
  36. setLastUpdateTime();
  38. //自动刷新
  39. mPullListView.doPullRefreshing(true,500);
  40. }
这是初始化一个下拉刷新的布局，并且调用setContentView来设置到Activity中。 在下拉刷新完成后，我们可以调用 onPullDownRefreshComplete()和onPullUpRefreshComplete()方法来停止刷新和加载

5. 运行效果

这里列出了demo的运行效果图。 Android 下拉刷新框架实现_第6张图片
图六、ListView下拉刷新，注意Header和Footer的样式
Android 下拉刷新框架实现_第7张图片
图七、WebView和ScrollView的下拉刷新效果图

6. 源码下载

实现这个下拉刷新的框架，并不是我的原创，我也是参考了很多开源的，把我认为比较好的东西借鉴过来，从而形成我的东西，我主要是参考了下面这个demo： https://github.com/chrisbanes/Android-PullToRefresh这个demo写得不错，不过他这个太复杂了，我们都知道，一旦复杂了，万一我们要添加一些需要，自然也要费劲一些，我其实就是把他的简化再简化，以满足我们自己的需要。
源码下载请猛点我
转载请说明出处 http://blog.csdn.net/leehong2005/article/details/12567757 谢谢！！！

7. Bug修复


 已知bug修复情况如下，发现了代码bug的看官也可以给我反馈，谢谢~~~
1，对于ListView的下拉刷新，当启用滚动到底自动加载时，如果footer由隐藏变为显示时，出现显示异常的情况 这个问题已经修复了，修正的代码如下：
  • PullToRefreshListView#setScrollLoadEnabled方法，修正后的代码如下：
[java] view plain copy
  1. @Override
  2. publicvoidsetScrollLoadEnabled(booleanscrollLoadEnabled){
  3. if(isScrollLoadEnabled()==scrollLoadEnabled){
  4. return;
  5. }
  7. super.setScrollLoadEnabled(scrollLoadEnabled);
  9. if(scrollLoadEnabled){
  10. //设置Footer
  11. if(null==mLoadMoreFooterLayout){
  12. mLoadMoreFooterLayout=newFooterLoadingLayout(getContext());
  13. mListView.addFooterView(mLoadMoreFooterLayout,null,false);
  14. }
  16. mLoadMoreFooterLayout.show(true);
  17. }else{
  18. if(null!=mLoadMoreFooterLayout){
  19. mLoadMoreFooterLayout.show(false);
  20. }
  21. }
  22. }
  • LoadingLayout#show方法，修正后的代码如下：
[java] view plain copy
  1. /**
  2. *显示或隐藏这个布局
  3. *
  4. *@paramshowflag
  5. */
  6. publicvoidshow(booleanshow){
  7. //Ifisshowing,donothing.
  8. if(show==(View.VISIBLE==getVisibility())){
  9. return;
  10. }
  12. ViewGroup.LayoutParamsparams=mContainer.getLayoutParams();
  13. if(null!=params){
  14. if(show){
  15. params.height=ViewGroup.LayoutParams.WRAP_CONTENT;
  16. }else{
  17. params.height=0;
  18. }
  20. requestLayout();
  21. setVisibility(show?View.VISIBLE:View.INVISIBLE);
  22. }
  23. }
在更改LayoutParameter后，调用requestLayout()方法。

更多相关文章

  1. Android 反编译apk 到java源码的方法
  2. android在使用RecyclerView布局里的androidstudio的模拟器虚拟键
  3. Android 开发资料总结--依赖注入框架
  4. Android布局——Linearlayout线性布局
  5. 混淆Android JAR包的方法
  6. eclipse：打开 eclipse 出现 “android sdk content loader 0%”
  7. MediaPlayer框架概述（一）
  8. Android 布局深度优化(减少布局层次)

随机推荐

  1. Linux第三章 命令基本格式及文件处理命令
  2. 弱智入门Linux——拉高CPU使用率
  3. gdb捕获syscall条件和字符串比较
  4. Linux命令-网络命令:netstat
  5. 学linux向那方面发展比较好
  6. 【Linux】Linux下使用wget 命令下载JDK7
  7. 我是这样学习Linux下C语言编程的-编译命
  8. Debian 7开启ssh、telnet
  9. Linux如何查找大文件
  10. linux中ioremap与ioremap_cachable的区别