Android(安卓)下拉刷新框架实现、仿新浪微博、QQ好友动态滑到底部自动加载
16lz
2021-01-25
苦苦找寻的2个版本,经过测试好用。再次感谢原作者!
1.第一个版本
Android 下拉刷新框架实现
http://blog.csdn.net/leehong2005/article/details/12567757
前段时间项目中用到了下拉刷新功能,之前在网上也找到过类似的demo,但这些demo的质量参差不齐,用户体验也不好,接口设计也不行。最张没办法,终于忍不了了,自己就写了一个下拉刷新的框架,这个框架是一个通用的框架,效果和设计感觉都还不错,现在分享给各位看官。
1. 关于下拉刷新
下拉刷新这种用户交互最早由twitter创始人洛伦•布里切特(Loren Brichter)发明, 有理论认为,下拉刷新是一种适用于按照从新到旧的时间顺序排列feeds的应用,在这种应用场景中看完旧的内容时,用户会很自然地下拉查找更新的内容,因此下拉刷新就显得非常合理。大家可以参考这篇文章: 有趣的下拉刷新,下面我贴出一个有趣的下拉刷新的案例。图一、有趣的下拉刷新案例(一)
图一、有趣的下拉刷新案例(二)
2. 实现原理
上面这些例子,外观做得再好看,他的本质上都一样,那就是一个下拉刷新控件通常由以下几部分组成: 【1】Header Header通常有下拉箭头,文字,进度条等元素,根据下拉的距离来改变它的状态,从而显示不同的样式 【2】Content 这部分是内容区域,网上有很多例子都是直接在ListView里面添加Header,但这就有局限性,因为好多情况下并不一定是用ListView来显示数据。我们把要显示内容的View放置在我们的一个容器中,如果你想实现一个用ListView显示数据的下拉刷新,你需要创建一个ListView旋转到我的容器中。我们处理这个容器的事件(down, move, up),如果向下拉,则把整个布局向下滑动,从而把header显示出来。 【3】Footer Footer可以用来显示向上拉的箭头,自动加载更多的进度条等。以上三部分总结的说来,就是如下图所示的这种布局结构: 图三,下拉刷新的布局结构
关于上图,需要说明几点: 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- publicinterfaceIPullToRefresh<TextendsView>{
- publicvoidsetPullRefreshEnabled(booleanpullRefreshEnabled);
- publicvoidsetPullLoadEnabled(booleanpullLoadEnabled);
- publicvoidsetScrollLoadEnabled(booleanscrollLoadEnabled);
- publicbooleanisPullRefreshEnabled();
- publicbooleanisPullLoadEnabled();
- publicbooleanisScrollLoadEnabled();
- publicvoidsetOnRefreshListener(OnRefreshListener<T>refreshListener);
- publicvoidonPullDownRefreshComplete();
- publicvoidonPullUpRefreshComplete();
- publicTgetRefreshableView();
- publicLoadingLayoutgetHeaderLoadingLayout();
- publicLoadingLayoutgetFooterLoadingLayout();
- publicvoidsetLastUpdatedLabel(CharSequencelabel);
- }
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会根据状态去显示相应的界面式样。
图四、PullToRefreshBase类的继承关系
关于PullToRefreshBase类及其派和类,有几点需要说明:
- 对于ListView,ScrollView,WebView这三种情况,他们是否滑动到最顶部或是最底部的实现是不一样的,所以,在PullToRefreshBase类中需要调用两个抽象方法来判断当前的位置是否在顶部或底部,而其派生类必须要实现这两个方法。比如对于ListView,它滑动到最顶部的条件就是第一个child完全可见并且first postion是0。这两个抽象方法是:
- /**
- *判断刷新的View是否滑动到顶部
- *
- *@returntrue表示已经滑动到顶部,否则false
- */
- protectedabstractbooleanisReadyForPullDown();
- /**
- *判断刷新的View是否滑动到底
- *
- *@returntrue表示已经滑动到底部,否则false
- */
- protectedabstractbooleanisReadyForPullUp();
- 创建可下拉刷新的View(也就是content view)的抽象方法是
- /**
- *创建可以刷新的View
- *
- *@paramcontextcontext
- *@paramattrs属性
- *@returnView
- */
- protectedabstractTcreateRefreshableView(Contextcontext,AttributeSetattrs);
- getContentSize
这个方法返回当前这个刷新Layout的大小,通常返回的是布局的高度,为了以后可以扩展为水平拉动,所以方法名字没有取成getLayoutHeight()之类的,这个返回值,将会作为松手后是否可以刷新的临界值,如果下拉的偏移值大于这个值,就认为可以刷新,否则不刷新,这个方法必须由派生类来实现。
- setState
这个方法用来设置当前刷新Layout的状态,PullToRefreshBase类会调用这个方法,当进入下拉,松手等动作时,都会调用这个方法,派生类里面只需要根据这些状态实现不同的界面显示,如下拉状态时,就显示出箭头,刷新状态时,就显示loading的图标。 可能的状态值有: RESET, PULL_TO_REFRESH, RELEASE_TO_REFRESH, REFRESHING, NO_MORE_DATA
LoadingLayout及其派生类的继承关系如下图所示:
图五、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- @Override
- publicvoidonCreate(BundlesavedInstanceState){
- super.onCreate(savedInstanceState);
- mPullListView=newPullToRefreshListView(this);
- setContentView(mPullListView);
- //上拉加载不可用
- mPullListView.setPullLoadEnabled(false);
- //滚动到底自动加载可用
- mPullListView.setScrollLoadEnabled(true);
- mCurIndex=mLoadDataCount;
- mListItems=newLinkedList<String>();
- mListItems.addAll(Arrays.asList(mStrings).subList(0,mCurIndex));
- mAdapter=newArrayAdapter<String>(this,android.R.layout.simple_list_item_1,mListItems);
- //得到实际的ListView
- mListView=mPullListView.getRefreshableView();
- //绑定数据
- mListView.setAdapter(mAdapter);
- //设置下拉刷新的listener
- mPullListView.setOnRefreshListener(newOnRefreshListener<ListView>(){
- @Override
- publicvoidonPullDownToRefresh(PullToRefreshBase<ListView>refreshView){
- mIsStart=true;
- newGetDataTask().execute();
- }
- @Override
- publicvoidonPullUpToRefresh(PullToRefreshBase<ListView>refreshView){
- mIsStart=false;
- newGetDataTask().execute();
- }
- });
- setLastUpdateTime();
- //自动刷新
- mPullListView.doPullRefreshing(true,500);
- }
5. 运行效果
这里列出了demo的运行效果图。图六、ListView下拉刷新,注意Header和Footer的样式
图七、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方法,修正后的代码如下:
- @Override
- publicvoidsetScrollLoadEnabled(booleanscrollLoadEnabled){
- if(isScrollLoadEnabled()==scrollLoadEnabled){
- return;
- }
- super.setScrollLoadEnabled(scrollLoadEnabled);
- if(scrollLoadEnabled){
- //设置Footer
- if(null==mLoadMoreFooterLayout){
- mLoadMoreFooterLayout=newFooterLoadingLayout(getContext());
- mListView.addFooterView(mLoadMoreFooterLayout,null,false);
- }
- mLoadMoreFooterLayout.show(true);
- }else{
- if(null!=mLoadMoreFooterLayout){
- mLoadMoreFooterLayout.show(false);
- }
- }
- }
- LoadingLayout#show方法,修正后的代码如下:
- /**
- *显示或隐藏这个布局
- *
- *@paramshowflag
- */
- publicvoidshow(booleanshow){
- //Ifisshowing,donothing.
- if(show==(View.VISIBLE==getVisibility())){
- return;
- }
- ViewGroup.LayoutParamsparams=mContainer.getLayoutParams();
- if(null!=params){
- if(show){
- params.height=ViewGroup.LayoutParams.WRAP_CONTENT;
- }else{
- params.height=0;
- }
- requestLayout();
- setVisibility(show?View.VISIBLE:View.INVISIBLE);
- }
- }
- 图片旋转兼容2.x系统
[java] view plain copy
- @Override
- publicvoidonPull(floatscale){
- if(null==mRotationHelper){
- mRotationHelper=newImageViewRotationHelper(mArrowImageView);
- }
- floatangle=scale*180f;//SUPPRESSCHECKSTYLE
- mRotationHelper.setRotation(angle);
- }
ImageViewRotationHelper主要的作用就是实现了ImageView的旋转功能,内部作了版本的区分,实现代码如下:
[java] view plain copy
- /**
- *Theimageviewrotationhelper
- *
- *@authorlihong06
- *@since2014-5-2
- */
- staticclassImageViewRotationHelper{
- /**Theimageview*/
- privatefinalImageViewmImageView;
- /**Thematrix*/
- privateMatrixmMatrix;
- /**PivotX*/
- privatefloatmRotationPivotX;
- /**PivotY*/
- privatefloatmRotationPivotY;
- /**
- *Theconstructormethod.
- *
- *@paramimageViewtheimageview
- */
- publicImageViewRotationHelper(ImageViewimageView){
- mImageView=imageView;
- }
- /**
- *Setsthedegreesthattheviewisrotatedaroundthepivotpoint.Increasingvalues
- *resultinclockwiserotation.
- *
- *@paramrotationThedegreesofrotation.
- *
- *@see#getRotation()
- *@see#getPivotX()
- *@see#getPivotY()
- *@see#setRotationX(float)
- *@see#setRotationY(float)
- *
- *@attrrefandroid.R.styleable#View_rotation
- */
- publicvoidsetRotation(floatrotation){
- if(APIUtils.hasHoneycomb()){
- mImageView.setRotation(rotation);
- }else{
- if(null==mMatrix){
- mMatrix=newMatrix();
- //计算旋转的中心点
- DrawableimageDrawable=mImageView.getDrawable();
- if(null!=imageDrawable){
- mRotationPivotX=Math.round(imageDrawable.getIntrinsicWidth()/2f);
- mRotationPivotY=Math.round(imageDrawable.getIntrinsicHeight()/2f);
- }
- }
- mMatrix.setRotate(rotation,mRotationPivotX,mRotationPivotY);
- mImageView.setImageMatrix(mMatrix);
- }
- }
- }
最核心的就是,如果在2.x的版本上,旋转ImageView使用Matrix。
- PullToRefreshBase构造方法兼容2.x
@TargetApi(Build.VERSION_CODES.HONEYCOMB)
2.第二个版本
Android自定义控件实战——仿新浪微博、QQ好友动态滑到底部自动加载
http://blog.csdn.net/zhongkejingwang/article/details/38963177
效果图如下:
下拉刷新的原理就不讲了,可以去看Android通用版下拉刷新上拉加载控件,实现自动加载的思路就是:
在ListView后面增加一个FooterView,时刻监听ListView的滑动状态,当FooterView被滑到可见时,执行自动加载操作。
但是这里需要注意的是手动滑到底和自由滚到底时的区别:
1、使劲滑的时候自由滚动在底部时会显示自动加载并执行加载回调
2、当用手慢慢滑动到底时,如果不松手,不会自动加载。
所以,基于这两个考虑,自然而然就需要覆写View的两个方法:onScrollChanged和onTouchEvent。
接下来就可以看代码了:
[java] view plain copy
- packagecom.jingchen.autoload;
- importandroid.content.Context;
- importandroid.graphics.drawable.AnimationDrawable;
- importandroid.util.AttributeSet;
- importandroid.view.LayoutInflater;
- importandroid.view.MotionEvent;
- importandroid.view.View;
- importandroid.widget.ImageView;
- importandroid.widget.ListView;
- importandroid.widget.TextView;
- /**
- *如果不需要下拉刷新直接在canPullDown中返回false,这里的自动加载和下拉刷新没有冲突,通过增加在尾部的footerview实现自动加载,
- *所以在使用中不要再动footerview了
- *
- *@authorchenjing
- *
- */
- publicclassPullableListViewextendsListViewimplementsPullable
- {
- publicstaticfinalintINIT=0;
- publicstaticfinalintLOADING=1;
- privateOnLoadListenermOnLoadListener;
- privateImageViewmLoadingView;
- privateTextViewmStateTextView;
- privateintstate=INIT;
- privatebooleancanLoad=true;
- privateAnimationDrawablemLoadAnim;
- publicPullableListView(Contextcontext)
- {
- super(context);
- init(context);
- }
- publicPullableListView(Contextcontext,AttributeSetattrs)
- {
- super(context,attrs);
- init(context);
- }
- publicPullableListView(Contextcontext,AttributeSetattrs,intdefStyle)
- {
- super(context,attrs,defStyle);
- init(context);
- }
- privatevoidinit(Contextcontext)
- {
- Viewview=LayoutInflater.from(context).inflate(R.layout.load_more,
- null);
- mLoadingView=(ImageView)view.findViewById(R.id.loading_icon);
- mLoadingView.setBackgroundResource(R.anim.loading_anim);
- mLoadAnim=(AnimationDrawable)mLoadingView.getBackground();
- mStateTextView=(TextView)view.findViewById(R.id.loadstate_tv);
- addFooterView(view,null,false);
- }
- @Override
- publicbooleanonTouchEvent(MotionEventev)
- {
- switch(ev.getActionMasked())
- {
- caseMotionEvent.ACTION_DOWN:
- //按下的时候禁止自动加载
- canLoad=false;
- break;
- caseMotionEvent.ACTION_UP:
- //松开手判断是否自动加载
- canLoad=true;
- checkLoad();
- break;
- }
- returnsuper.onTouchEvent(ev);
- }
- @Override
- protectedvoidonScrollChanged(intl,intt,intoldl,intoldt)
- {
- super.onScrollChanged(l,t,oldl,oldt);
- //在滚动中判断是否满足自动加载条件
- checkLoad();
- }
- /**
- *判断是否满足自动加载条件
- */
- privatevoidcheckLoad()
- {
- if(reachBottom()&&mOnLoadListener!=null&&state!=LOADING
- &&canLoad)
- {
- mOnLoadListener.onLoad(this);
- changeState(LOADING);
- }
- }
- privatevoidchangeState(intstate)
- {
- this.state=state;
- switch(state)
- {
- caseINIT:
- mLoadAnim.stop();
- mLoadingView.setVisibility(View.INVISIBLE);
- mStateTextView.setText(R.string.more);
- break;
- caseLOADING:
- mLoadingView.setVisibility(View.VISIBLE);
- mLoadAnim.start();
- mStateTextView.setText(R.string.loading);
- break;
- }
- }
- /**
- *完成加载
- */
- publicvoidfinishLoading()
- {
- changeState(INIT);
- }
- @Override
- publicbooleancanPullDown()
- {
- if(getCount()==0)
- {
- //没有item的时候也可以下拉刷新
- returntrue;
- }elseif(getFirstVisiblePosition()==0
- &&getChildAt(0).getTop()>=0)
- {
- //滑到ListView的顶部了
- returntrue;
- }else
- returnfalse;
- }
- publicvoidsetOnLoadListener(OnLoadListenerlistener)
- {
- this.mOnLoadListener=listener;
- }
- /**
- *@returnfooterview可见时返回true,否则返回false
- */
- publicbooleanreachBottom()
- {
- if(getCount()==0)
- {
- //没有item的时候也可以上拉加载
- returntrue;
- }elseif(getLastVisiblePosition()==(getCount()-1))
- {
- //滑到底部了
- if(getChildAt(getLastVisiblePosition()-getFirstVisiblePosition())!=null
- &&getChildAt(
- getLastVisiblePosition()
- -getFirstVisiblePosition()).getTop()<getMeasuredHeight())
- returntrue;
- }
- returnfalse;
- }
- publicinterfaceOnLoadListener
- {
- voidonLoad(PullableListViewpullableListView);
- }
- }
Pullable接口是实现下拉刷新的,不用管。代码中判断滑动到底部是根据FooterView的上边缘距离ListView底部的距离。这个功能实现起来没什么难度,其他代码就不贴上来了,下面提供源码下载:
源码下载:https://github.com/jingchenUSTC/AutoLoad
更多相关文章
- android中进程与线程
- android飞行模式灰显不能操作问题分解
- Service与Android系统设计(2)-- Parcel
- Android学习笔记之ImageSwitcher
- Android为ToolBar设置沉浸式状态栏及其相关问题处理
- Android(安卓)Snackbar使用详解
- 静态扫描工具提升Android代码质量
- Android(安卓)SAX方式解析XML文件
- Android坐标的简单方法介绍