Android下拉刷新框架實現(xiàn)代碼實例
前段時間項目中用到了下拉刷新功能,之前在網(wǎng)上也找到過類似的demo,但這些demo的質量參差不齊,用戶體驗也不好,接口設計也不行。最張沒辦法,終于忍不了了,自己就寫了一個下拉刷新的框架,這個框架是一個通用的框架,效果和設計感覺都還不錯,現(xiàn)在分享給各位看官。
一. 關于下拉刷新
下拉刷新這種用戶交互最早由twitter創(chuàng)始人洛倫•布里切特(Loren Brichter)發(fā)明,有理論認為,下拉刷新是一種適用于按照從新到舊的時間順序排列feeds的應用,在這種應用場景中看完舊的內容時,用戶會很自然地下拉查找更新的內容,因此下拉刷新就顯得非常合理。大家可以參考這篇文章:有趣的下拉刷新,下面我貼出一個有趣的下拉刷新的案例。
圖一、有趣的下拉刷新案例(一)
圖二、有趣的下拉刷新案例(二)
二. 實現(xiàn)原理
上面這些例子,外觀做得再好看,他的本質上都一樣,那就是一個下拉刷新控件通常由以下幾部分組成:
【1】Header
Header通常有下拉箭頭,文字,進度條等元素,根據(jù)下拉的距離來改變它的狀態(tài),從而顯示不同的樣式
【2】Content
這部分是內容區(qū)域,網(wǎng)上有很多例子都是直接在ListView里面添加Header,但這就有局限性,因為好多情況下并不一定是用ListView來顯示數(shù)據(jù)。我們把要顯示內容的View放置在我們的一個容器中,如果你想實現(xiàn)一個用ListView顯示數(shù)據(jù)的下拉刷新,你需要創(chuàng)建一個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、派生類需要實現(xiàn)的是:將Content View填充到父容器中,比如,如果你要使用的話,那么你需要把ListView, ScrollView, WebView等添加到容器中。
6、上圖中的紅色區(qū)域就是屏的大?。▏栏駚碚f,這里說屏幕大小并不準確,應該說成內容區(qū)域更加準確)
三. 具體實現(xiàn)
明白了實現(xiàn)原理與過程,我們嘗試來具體實現(xiàn),首先,為了以后更好地擴展,設計更加合理,我們把下拉刷新的功能抽象成一個接口:
1、IPullToRefresh<T extends View>
它具體的定義方法如下:
public interface IPullToRefresh<T extends View> {
public void setPullRefreshEnabled(boolean pullRefreshEnabled);
public void setPullLoadEnabled(boolean pullLoadEnabled);
public void setScrollLoadEnabled(boolean scrollLoadEnabled);
public boolean isPullRefreshEnabled();
public boolean isPullLoadEnabled();
public boolean isScrollLoadEnabled();
public void setOnRefreshListener(OnRefreshListener<T> refreshListener);
public void onPullDownRefreshComplete();
public void onPullUpRefreshComplete();
public T getRefreshableView();
public LoadingLayout getHeaderLoadingLayout();
public LoadingLayout getFooterLoadingLayout();
public void setLastUpdatedLabel(CharSequence label);
}
這個接口是一個泛型的,它接受View的派生類,因為要放到我們的容器中的不就是一個View嗎?
2、PullToRefreshBase<T extends View>
這個類實現(xiàn)了IPullToRefresh接口,它是從LinearLayout繼承過來,作為下拉刷新的一個抽象基類,如果你想實現(xiàn)ListView的下拉刷新,只需要擴展這個類,實現(xiàn)一些必要的方法就可以了。這個類的職責主要有以下幾點:
- 處理onInterceptTouchEvent()和onTouchEvent()中的事件:當內容的View(比如ListView)正如處于最頂部,此時再向下拉,我們必須截斷事件,然后move事件就會把后續(xù)的事件傳遞到onTouchEvent()方法中,然后再在這個方法中,我們根據(jù)move的距離再進行scroll整個View。
- 負責創(chuàng)建Header、Footer和Content View:在構造方法中調用方法去創(chuàng)建這三個部分的View,派生類可以重寫這些方法,以提供不同式樣的Header和Footer,它會調用createHeaderLoadingLayout和createFooterLoadingLayout方法來創(chuàng)建Header和Footer創(chuàng)建Content View的方法是一個抽象方法,必須讓派生類來實現(xiàn),返回一個非null的View,然后容器再把這個View添加到自己里面。
- 設置各種狀態(tài):這里面有很多狀態(tài),如下拉、上拉、刷新、加載中、釋放等,它會根據(jù)用戶拉動的距離來更改狀態(tài),狀態(tài)的改變,它也會把Header和Footer的狀態(tài)改變,然后Header和Footer會根據(jù)狀態(tài)去顯示相應的界面式樣。
3、PullToRefreshBase<T extends View>繼承關系
這里我實現(xiàn)了三個下拉刷新的派生類,分別是ListView、ScrollView、WebView三個,它們的繼承關系如下:

圖四、PullToRefreshBase類的繼承關系
關于PullToRefreshBase類及其派和類,有幾點需要說明:
對于ListView,ScrollView,WebView這三種情況,他們是否滑動到最頂部或是最底部的實現(xiàn)是不一樣的,所以,在PullToRefreshBase類中需要調用兩個抽象方法來判斷當前的位置是否在頂部或底部,而其派生類必須要實現(xiàn)這兩個方法。比如對于ListView,它滑動到最頂部的條件就是第一個child完全可見并且first postion是0。這兩個抽象方法是:
/** * 判斷刷新的View是否滑動到頂部 * * @return true表示已經滑動到頂部,否則false */ protected abstract boolean isReadyForPullDown(); /** * 判斷刷新的View是否滑動到底 * * @return true表示已經滑動到底部,否則false */ protected abstract boolean isReadyForPullUp();
創(chuàng)建可下拉刷新的View(也就是content view)的抽象方法是
/** * 創(chuàng)建可以刷新的View * * @param context context * @param attrs 屬性 * @return View */ protected abstract T createRefreshableView(Context context, AttributeSet attrs);
4、LoadingLayout
LoadingLayout是刷新Layout的一個抽象,它是一個抽象基類。Header和Footer都擴展于這個類。這類抽象類,提供了兩個抽象方法:
getContentSize
這個方法返回當前這個刷新Layout的大小,通常返回的是布局的高度,為了以后可以擴展為水平拉動,所以方法名字沒有取成getLayoutHeight()之類的,這個返回值,將會作為松手后是否可以刷新的臨界值,如果下拉的偏移值大于這個值,就認為可以刷新,否則不刷新,這個方法必須由派生類來實現(xiàn)。
setState
這個方法用來設置當前刷新Layout的狀態(tài),PullToRefreshBase類會調用這個方法,當進入下拉,松手等動作時,都會調用這個方法,派生類里面只需要根據(jù)這些狀態(tài)實現(xiàn)不同的界面顯示,如下拉狀態(tài)時,就顯示出箭頭,刷新狀態(tài)時,就顯示loading的圖標。
可能的狀態(tài)值有:RESET, PULL_TO_REFRESH, RELEASE_TO_REFRESH, REFRESHING, NO_MORE_DATA
LoadingLayout及其派生類的繼承關系如下圖所示:

圖五、LoadingLayout及其派生類的類圖
我們可以隨意地制定自己的Header和Footer,我們也可以實現(xiàn)如圖一和圖二中顯示的各種下拉刷新案例中的Header和Footer,只要重寫上述兩個方法getContentSize()和setState()就行了。HeaderLoadingLayout,它默認是顯示箭頭式樣的布局,而RotateLoadingLayout則是顯示一個旋轉圖標的式樣。
5、事件處理
我們必須重寫PullToRefreshBase類的兩個事件相關的方法onInterceptTouchEvent()和onTouchEvent()方法。由于ListView,ScrollView,WebView它們是放到PullToRefreshBase內部的,所在事件先是傳遞到PullToRefreshBase#onInterceptTouchEvent()方法中,所以我們應該在這個方法中去處理ACTION_MOVE事件,判斷如果當前ListView,ScrollView,WebView是否在最頂部或最底部,如果是,則開始截斷事件,一旦事件被截斷,后續(xù)的事件就會傳遞到PullToRefreshBase#onInterceptTouchEvent()方法中,我們再在ACTION_MOVE事件中去移動整個布局,從而實現(xiàn)下拉或上拉動作。
6、滾動布局(scrollTo)
如圖三的布局結構可知,默認情況下Header和Footer是放置在Content View的最上面和最下面,通過設置padding來讓他跑到屏幕外面去了,如果我們將整個布局向下滾動(scrollTo)一定距離,那么Header就會被顯示出來,基于這種情況,所以在我的實現(xiàn)中,最終我是調用scrollTo來實現(xiàn)下拉動作的。
總的說來,實現(xiàn)的重要的點就這些,具體的一些細節(jié)在實現(xiàn)在會碰到很多,可以參考代碼。
四. 如何使用
使用下拉刷新的代碼如下
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mPullListView = new PullToRefreshListView(this);
setContentView(mPullListView);
// 上拉加載不可用
mPullListView.setPullLoadEnabled(false);
// 滾動到底自動加載可用
mPullListView.setScrollLoadEnabled(true);
mCurIndex = mLoadDataCount;
mListItems = new LinkedList<String>();
mListItems.addAll(Arrays.asList(mStrings).subList(0, mCurIndex));
mAdapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, mListItems);
// 得到實際的ListView
mListView = mPullListView.getRefreshableView();
// 綁定數(shù)據(jù)
mListView.setAdapter(mAdapter);
// 設置下拉刷新的listener
mPullListView.setOnRefreshListener(new OnRefreshListener<ListView>() {
@Override
public void onPullDownToRefresh(PullToRefreshBase<ListView> refreshView) {
mIsStart = true;
new GetDataTask().execute();
}
@Override
public void onPullUpToRefresh(PullToRefreshBase<ListView> refreshView) {
mIsStart = false;
new GetDataTask().execute();
}
});
setLastUpdateTime();
// 自動刷新
mPullListView.doPullRefreshing(true, 500);
}
這是初始化一個下拉刷新的布局,并且調用setContentView來設置到Activity中。
在下拉刷新完成后,我們可以調用onPullDownRefreshComplete()和onPullUpRefreshComplete()方法來停止刷新和加載
五. 運行效果
這里列出了demo的運行效果圖。

圖六、ListView下拉刷新,注意Header和Footer的樣式
六. Bug修復
已知bug修復情況如下,發(fā)現(xiàn)了代碼bug的看官也可以給我反饋,謝謝~~~
1,對于ListView的下拉刷新,當啟用滾動到底自動加載時,如果footer由隱藏變?yōu)轱@示時,出現(xiàn)顯示異常的情況
這個問題已經修復了,修正的代碼如下:
PullToRefreshListView#setScrollLoadEnabled方法,修正后的代碼如下:
@Override
public void setScrollLoadEnabled(boolean scrollLoadEnabled) {
if (isScrollLoadEnabled() == scrollLoadEnabled) {
return;
}
super.setScrollLoadEnabled(scrollLoadEnabled);
if (scrollLoadEnabled) {
// 設置Footer
if (null == mLoadMoreFooterLayout) {
mLoadMoreFooterLayout = new FooterLoadingLayout(getContext());
mListView.addFooterView(mLoadMoreFooterLayout, null, false);
}
mLoadMoreFooterLayout.show(true);
} else {
if (null != mLoadMoreFooterLayout) {
mLoadMoreFooterLayout.show(false);
}
}
}
LoadingLayout#show方法,修正后的代碼如下:
/**
* 顯示或隱藏這個布局
*
* @param show flag
*/
public void show(boolean show) {
// If is showing, do nothing.
if (show == (View.VISIBLE == getVisibility())) {
return;
}
ViewGroup.LayoutParams params = mContainer.getLayoutParams();
if (null != params) {
if (show) {
params.height = ViewGroup.LayoutParams.WRAP_CONTENT;
} else {
params.height = 0;
}
requestLayout();
setVisibility(show ? View.VISIBLE : View.INVISIBLE);
}
}
在更改LayoutParameter后,調用requestLayout()方法。
圖片旋轉兼容2.x系統(tǒng)
我之前想的是這個只需要兼容3.x以上的系統(tǒng),但發(fā)現(xiàn)有很多網(wǎng)友在使用過程中遇到過兼容性問題,這次抽空將這個兼容性一并實現(xiàn)了。
onPull的修改如下:
@Override
public void onPull(float scale) {
if (null == mRotationHelper) {
mRotationHelper = new ImageViewRotationHelper(mArrowImageView);
}
float angle = scale * 180f; // SUPPRESS CHECKSTYLE
mRotationHelper.setRotation(angle);
}
ImageViewRotationHelper主要的作用就是實現(xiàn)了ImageView的旋轉功能,內部作了版本的區(qū)分,實現(xiàn)代碼如下:
/**
* The image view rotation helper
*
* @author lihong06
* @since 2014-5-2
*/
static class ImageViewRotationHelper {
/** The imageview */
private final ImageView mImageView;
/** The matrix */
private Matrix mMatrix;
/** Pivot X */
private float mRotationPivotX;
/** Pivot Y */
private float mRotationPivotY;
/**
* The constructor method.
*
* @param imageView the image view
*/
public ImageViewRotationHelper(ImageView imageView) {
mImageView = imageView;
}
/**
* Sets the degrees that the view is rotated around the pivot point. Increasing values
* result in clockwise rotation.
*
* @param rotation The degrees of rotation.
*
* @see #getRotation()
* @see #getPivotX()
* @see #getPivotY()
* @see #setRotationX(float)
* @see #setRotationY(float)
*
* @attr ref android.R.styleable#View_rotation
*/
public void setRotation(float rotation) {
if (APIUtils.hasHoneycomb()) {
mImageView.setRotation(rotation);
} else {
if (null == mMatrix) {
mMatrix = new Matrix();
// 計算旋轉的中心點
Drawable imageDrawable = 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
在三個參數(shù)的構造方法聲明如下標注:
@SuppressLint("NewApi")
@TargetApi(Build.VERSION_CODES.HONEYCOMB)
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
Ubuntu 14.04下創(chuàng)建Genymotion安卓虛擬機的步驟詳解
Android 模擬器一直以速度奇慢無比著稱,基本慢到不可用。本文介紹我一直在用的 Genymotion,速度不亞于真機。而且功能齊全,使用簡單。下面這篇文章主要介紹了Ubuntu 14.04下創(chuàng)建Genymotion虛擬機的步驟,需要的朋友可以參考下。2017-03-03
使用SharedPreferences在Android存儲對象詳細代碼
這篇文章主要介紹了使用SharedPreferences在Android存儲對象并附上詳細代碼,下面文章內容較少,大多以代碼的形式體現(xiàn),需要的小伙伴可以參考一下,希望對你有所幫助2021-11-11
Android實現(xiàn)讀取相機(相冊)圖片并進行剪裁
在 Android應用中,很多時候我們需要實現(xiàn)上傳圖片,或者直接調用手機上的拍照功能拍照處理然后直接顯示并上傳功能,下面將講述調用相機拍照處理圖片然后顯示和調用手機相冊中的圖片處理然后顯示的功能2015-08-08
Android ListView與getView調用卡頓問題解決辦法
這篇文章主要介紹了Android ListView與getView調用卡頓問題解決辦法的相關資料,這里提供實例及解決辦法幫助大家解決這種問題,需要的朋友可以參考下2017-08-08
Android實現(xiàn)Banner界面廣告圖片循環(huán)輪播(包括實現(xiàn)手動滑動循環(huán))
這篇文章主要介紹了Android實現(xiàn)Banner界面廣告圖片循環(huán)輪播(包括實現(xiàn)手動滑動循環(huán))的相關資料,需要的朋友可以參考下2016-02-02
Android編程實現(xiàn)文件瀏覽功能的方法【類似于FileDialog的功能】
這篇文章主要介紹了Android編程實現(xiàn)文件瀏覽功能的方法,可實現(xiàn)類似于FileDialog的功能,涉及Android針對文件與目錄操作的相關技巧,需要的朋友可以參考下2016-11-11

