listView下拉刷新(仿sina微博Android客戶端效果)
這個下拉效果在網上最早的例子恐怕就是Johan Nilsson的實現,https://johannilsson.com/2011/03/13/android-pull-to-refresh-update.html。
後麵的很多例子應該都是仿照這個寫的,下麵的這個例子就是對這個例子的修改,先看下一個點擊的效果,我看到其他的分析博客裏麵沒有談到這一點,在這個代碼中,我們一直看到是listview的第二項,而listview的第一項被遮擋了起來,滑動至第一項:
點擊頭條,頭條會變成以下:
然後,過一段時間,刷新完成以後,listview又setSelection(1),增加一條數據,同時,把頂部給遮擋住:
這是點擊刷新,然後是下拉刷新:
最後結果和點擊刷新相同。那現在開始看下代碼:
首先看下所用到的控件和變量:
- // 狀態
- private static final int TAP_TO_REFRESH = 1;//點擊刷新
- private static final int PULL_TO_REFRESH = 2; //拉動刷新
- private static final int RELEASE_TO_REFRESH = 3; //釋放刷新
- private static final int REFRESHING = 4; //正在刷新
- // 當前滑動狀態
- private int mCurrentScrollState;
- // 當前刷新狀態
- private int mRefreshState;
- //頭視圖的高度
- private int mRefreshViewHeight;
- //頭視圖 原始的top padding 屬性值
- private int mRefreshOriginalTopPadding;
- private int mLastMotionY;
- // 監聽對listview的滑動動作
- private OnRefreshListener mOnRefreshListener;
- //箭頭圖片
- private static int REFRESHICON = R.drawable.goicon;
- //listview 滾動監聽器
- private OnScrollListener mOnScrollListener;
- private LayoutInflater mInflater;
- private RelativeLayout mRefreshView;
- //頂部刷新時出現的控件
- private TextView mRefreshViewText;
- private ImageView mRefreshViewImage;
- private ProgressBar mRefreshViewProgress;
- private TextView mRefreshViewLastUpdated;
- // 箭頭動畫效果
- //變為向下的箭頭
- private RotateAnimation mFlipAnimation;
- //變為逆向的箭頭
- private RotateAnimation mReverseFlipAnimation;
- //是否反彈
- private boolean mBounceHack;
在init()方法中初始化各個控件及設置監聽:
- private void init(Context context) {
- // Load all of the animations we need in code rather than through XML
- mFlipAnimation = new RotateAnimation(0, -180,RotateAnimation.RELATIVE_TO_SELF,
- 0.5f,RotateAnimation.RELATIVE_TO_SELF, 0.5f);
- mFlipAnimation.setInterpolator(new LinearInterpolator());
- mFlipAnimation.setDuration(250);
- mFlipAnimation.setFillAfter(true);
- mReverseFlipAnimation = new RotateAnimation(-180, 0,RotateAnimation.RELATIVE_TO_SELF, 0.5f,RotateAnimation.RELATIVE_TO_SELF, 0.5f);
- mReverseFlipAnimation.setInterpolator(new LinearInterpolator());
- mReverseFlipAnimation.setDuration(250);
- mReverseFlipAnimation.setFillAfter(true);
- mInflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
- mRefreshView = (RelativeLayout) mInflater.inflate(R.layout.pull_to_refresh_header, this, false);
- mRefreshViewText =(TextView) mRefreshView.findViewById(R.id.pull_to_refresh_text);
- mRefreshViewImage =(ImageView) mRefreshView.findViewById(R.id.pull_to_refresh_image);
- mRefreshViewProgress =(ProgressBar) mRefreshView.findViewById(R.id.pull_to_refresh_progress);
- mRefreshViewLastUpdated =(TextView) mRefreshView.findViewById(R.id.pull_to_refresh_updated_at);
- mRefreshViewImage.setMinimumHeight(50);
- mRefreshView.setOnClickListener(new OnClickRefreshListener());
- mRefreshOriginalTopPadding = mRefreshView.getPaddingTop();
- mRefreshState = TAP_TO_REFRESH;
- //為listview頭部增加一個view
- addHeaderView(mRefreshView);
- super.setOnScrollListener(this);
- measureView(mRefreshView);
- mRefreshViewHeight = mRefreshView.getMeasuredHeight();
- }
- mRefreshView.setOnClickListener(new OnClickRefreshListener());
我們再來看下監聽事件的定義:
- private class OnClickRefreshListener implements OnClickListener {
- @Override
- public void onClick(View v) {
- if (mRefreshState != REFRESHING) {
- prepareForRefresh();
- onRefresh();
- }
- }
- }
調用了preparForRefresh()(準備刷新)和onRefresh()(刷新)兩個方法,然後在查看這兩個方法的定義:
- public void prepareForRefresh() {
- resetHeaderPadding(); // 恢複header的邊距
- mRefreshViewImage.setVisibility(View.GONE);
- // We need this hack, otherwise it will keep the previous drawable.
- // 注意加上,否則仍然顯示之前的圖片
- mRefreshViewImage.setImageDrawable(null);
- mRefreshViewProgress.setVisibility(View.VISIBLE);
- // Set refresh view text to the refreshing label
- mRefreshViewText.setText(R.string.pull_to_refresh_refreshing_label);
- mRefreshState = REFRESHING;
- }
- public void onRefresh() {
- if (mOnRefreshListener != null) {
- mOnRefreshListener.onRefresh();
- }
- }
其中,後者還是回調方法。
我們看下preparForRefresh()方法中,引用了resetHeadPadding()方法:
- /**
- * Sets the header padding back to original size.
- * 將head的邊距重置為初始的數值
- */
- private void resetHeaderPadding() {
- mRefreshView.setPadding(
- mRefreshView.getPaddingLeft(),
- mRefreshOriginalTopPadding,
- mRefreshView.getPaddingRight(),
- mRefreshView.getPaddingBottom());
- }
從新設置下header距上下左右的距離。
最重要的方法應該是:onScroll()和onTouchEvent()方法,先看下onTouchEvent()方法:
- @Override
- public boolean onTouchEvent(MotionEvent event) {
- //當前手指的Y值
- final int y = (int) event.getY();
- mBounceHack = false;
- switch (event.getAction()) {
- case MotionEvent.ACTION_UP:
- //將垂直滾動條設置為可用狀態
- if (!isVerticalScrollBarEnabled()) {
- setVerticalScrollBarEnabled(true);
- }
- if (getFirstVisiblePosition() == 0 && mRefreshState != REFRESHING) {
- // 拖動距離達到刷新需要
- if ((mRefreshView.getBottom() >= mRefreshViewHeight
- || mRefreshView.getTop() >= 0)
- && mRefreshState == RELEASE_TO_REFRESH) {
- // 把狀態設置為正在刷新
- // Initiate the refresh
- mRefreshState = REFRESHING; //將標量設置為,正在刷新
- // 準備刷新
- prepareForRefresh();
- // 刷新
- onRefresh();
- } else if (mRefreshView.getBottom() < mRefreshViewHeight
- || mRefreshView.getTop() <= 0) {
- // Abort refresh and scroll down below the refresh view
- //停止刷新,並且滾動到頭部刷新視圖的下一個視圖
- resetHeader();
- setSelection(1); //定位在第二個列表項
- }
- }
- break;
- case MotionEvent.ACTION_DOWN:
- // 獲得按下y軸位置
- mLastMotionY = y;
- break;
- case MotionEvent.ACTION_MOVE:
- //更行頭視圖的toppadding 屬性
- applyHeaderPadding(event);
- break;
- }
- return super.onTouchEvent(event);
- }
當按下的時候,記錄按下y軸的位置,然後在move中調用了applyHeaderPadding()方法,我們再看下這個方法:
- // 獲得header距離
- private void applyHeaderPadding(MotionEvent ev) {
- //獲取累積的動作數
- int pointerCount = ev.getHistorySize();
- for (int p = 0; p < pointerCount; p++) {
- //如果是釋放將要刷新狀態
- if (mRefreshState == RELEASE_TO_REFRESH) {
- if (isVerticalFadingEdgeEnabled()) {
- setVerticalScrollBarEnabled(false);
- }
- //曆史累積的高度
- int historicalY = (int) ev.getHistoricalY(p);
- // Calculate the padding to apply, we divide by 1.7 to
- // simulate a more resistant effect during pull.
- // 計算申請的邊距,除以1.7使得拉動效果更好
- int topPadding = (int) (((historicalY - mLastMotionY)- mRefreshViewHeight) / 1.7);
- mRefreshView.setPadding(
- mRefreshView.getPaddingLeft(),
- topPadding,
- mRefreshView.getPaddingRight(),
- mRefreshView.getPaddingBottom());
- }
- }
- }
通過記錄滑動距離,實時變化頭部mRefreshView的上下左右的距離。
最後,看下手指鬆開的ACTION_UP:
- case MotionEvent.ACTION_UP:
- //將垂直滾動條設置為可用狀態
- if (!isVerticalScrollBarEnabled()) {
- setVerticalScrollBarEnabled(true);
- }
- if (getFirstVisiblePosition() == 0 && mRefreshState != REFRESHING) {
- // 拖動距離達到刷新需要
- if ((mRefreshView.getBottom() >= mRefreshViewHeight
- || mRefreshView.getTop() >= 0)
- && mRefreshState == RELEASE_TO_REFRESH) {
- // 把狀態設置為正在刷新
- // Initiate the refresh
- mRefreshState = REFRESHING; //將標量設置為:正在刷新
- // 準備刷新
- prepareForRefresh();
- // 刷新
- onRefresh();
- } else if (mRefreshView.getBottom() < mRefreshViewHeight
- || mRefreshView.getTop() <= 0) {
- // Abort refresh and scroll down below the refresh view
- //停止刷新,並且滾動到頭部刷新視圖的下一個視圖
- resetHeader();
- setSelection(1); //定位在第二個列表項
- }
- }
- break;
當滑動距離大於一個item的距離時,添加一個item,否則,彈回。
看完onTouchEvent(),然後再看一下onScroll()方法:
- @Override
- public void onScroll(AbsListView view, int firstVisibleItem,int visibleItemCount, int totalItemCount) {
- // When the refresh view is completely visible, change the text to say
- // "Release to refresh..." and flip the arrow drawable.
- // 在refreshview完全可見時,設置文字為鬆開刷新,同時翻轉箭頭
- //如果是接觸滾動狀態,並且不是正在刷新的狀態
- if (mCurrentScrollState == SCROLL_STATE_TOUCH_SCROLL&& mRefreshState != REFRESHING) {
- if (firstVisibleItem == 0) {
- //如果顯示出來了第一個列表項,顯示刷新圖片
- mRefreshViewImage.setVisibility(View.VISIBLE);
- //如果下拉了listiview,則顯示上拉刷新動畫
- if ((mRefreshView.getBottom() >= mRefreshViewHeight + 20|| mRefreshView.getTop() >= 0)
- && mRefreshState != RELEASE_TO_REFRESH) {
- mRefreshViewText.setText(R.string.pull_to_refresh_release_label);
- mRefreshViewImage.clearAnimation();
- mRefreshViewImage.startAnimation(mFlipAnimation);
- mRefreshState = RELEASE_TO_REFRESH;
- //如果下拉距離不夠,則回歸原來的狀態
- } else if (mRefreshView.getBottom() < mRefreshViewHeight + 20
- && mRefreshState != PULL_TO_REFRESH) {
- mRefreshViewText.setText(R.string.pull_to_refresh_pull_label);
- if (mRefreshState != TAP_TO_REFRESH) {
- mRefreshViewImage.clearAnimation();
- mRefreshViewImage.startAnimation(mReverseFlipAnimation);
- }
- mRefreshState = PULL_TO_REFRESH;
- }
- } else {
- mRefreshViewImage.setVisibility(View.GONE);
- resetHeader();
- }
- //如果是滾動狀態+ 第一個視圖已經顯示+ 不是刷新狀態
- } else if (mCurrentScrollState == SCROLL_STATE_FLING && firstVisibleItem == 0
- && mRefreshState != REFRESHING) {
- setSelection(1);
- mBounceHack = true;
- } else if (mBounceHack && mCurrentScrollState == SCROLL_STATE_FLING) {
- setSelection(1);
- }
- if (mOnScrollListener != null) {
- mOnScrollListener.onScroll(view, firstVisibleItem,visibleItemCount, totalItemCount);
- }
- }
該方法是在滑動過程中,各種狀況的處理。
onScroll()方法和onTouchEvent()方法的執行過程應該是,先onTouchEvent()的ACTION_DOWN,然後是ACTION_MOVE和onScroll()方法同時進行,最後是onTouchEvent()的ACTION_UP。也可以自己打log看一下。這樣在onTouchEvent()處理header,就是mRefreshView的外部的各個熟悉,onScroll()裏麵處理header(mRefreshView)裏麵內部的控件變化,從邏輯上來說比較清晰。
在onScroll()中,引用方法resetHeader()方法:
- /**
- * Resets the header to the original state.
- * 重置header為之前的狀態
- */
- private void resetHeader() {
- if (mRefreshState != TAP_TO_REFRESH) {
- mRefreshState = TAP_TO_REFRESH;
- resetHeaderPadding();
- // 將刷新圖標換成箭頭
- // Set refresh view text to the pull label
- mRefreshViewText.setText(R.string.pull_to_refresh_tap_label);
- // Replace refresh drawable with arrow drawable
- // 清除動畫
- mRefreshViewImage.setImageResource(REFRESHICON);
- // Clear the full rotation animation
- mRefreshViewImage.clearAnimation();
- // Hide progress bar and arrow.
- // 隱藏圖標和進度條
- mRefreshViewImage.setVisibility(View.GONE);
- mRefreshViewProgress.setVisibility(View.GONE);
- }
- }
resetHead就是header(mRefreshView)的內部的具體操作。
當一切都完成以後,就可以調用onRefreshComplete()方法:
- /**
- * Resets the list to a normal state after a refresh.
- * 重置listview為普通的listview
- * @param lastUpdated
- * Last updated at.
- */
- public void onRefreshComplete(CharSequence lastUpdated) {
- setLastUpdated(lastUpdated);
- onRefreshComplete();
- }
- /**
- * Resets the list to a normal state after a refresh.
- * 重置listview為普通的listview,
- */
- public void onRefreshComplete() {
- resetHeader();
- // If refresh view is visible when loading completes, scroll down to
- // the next item.
- if (mRefreshView.getBottom() > 0) {
- invalidateViews(); //重繪視圖
- setSelection(1);
- }
- }
最後更新:2017-04-02 17:09:29