Android PullToRefresh（下拉刷新）的使用詳解

原創 tuke_tuke 2020-07-02 17:03

開源項地址：https://github.com/chrisbanes/Android-PullToRefresh

在Android-PullToRefresh-master文件夾下，我們會看到還有三個文件夾：extras，
library，sample。其中sample就是作者爲我們提供的Demo，library是我們在使用Sample必須用到的jar。extras中是使用ListFragment和ViewPage用到的jar。

裏面有三個庫工程分別導入到eclipse中：



最主要的還是library庫工程

創建自己工程project，然後查看project的properties->android項，在下面添加依賴庫



然後就可以使用了

最基本的使用：

xml文件：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >
    
    <com.handmark.pulltorefresh.library.PullToRefreshListView    
        android:id="@+id/pull_refresh_list"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
  
     />
    
</LinearLayout>

聲明瞭一個PullToRefreshListView，裏面所有的屬性都是ListView的，沒有任何其他屬性，當然了PullToRefreshListView也提供了很多配置的屬性，後面會詳細介紹。

package com.hust.mydemo;

import java.util.Arrays;
import java.util.LinkedList;

import com.handmark.pulltorefresh.library.PullToRefreshBase;
import com.handmark.pulltorefresh.library.PullToRefreshBase.Mode;
import com.handmark.pulltorefresh.library.PullToRefreshBase.OnLastItemVisibleListener;
import com.handmark.pulltorefresh.library.PullToRefreshBase.OnRefreshListener;
import com.handmark.pulltorefresh.library.PullToRefreshListView;

import android.R.integer;
import android.app.Activity;
import android.os.AsyncTask;
import android.os.Bundle;
import android.text.AndroidCharacter;
import android.text.format.DateUtils;
import android.view.Menu;
import android.view.MenuItem;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.Toast;


public class MainActivity extends Activity {
    
	PullToRefreshListView mPullToRefreshListView;//下列刷新list
	ListView actualListView;
	LinkedList<String> listItems;//數據
	ArrayAdapter<String> adapter;//適配器
	
	private String[] mStrings = { 	
			"ListItem_00", "ListItem_01", "ListItem_02", "ListItem_03","ListItem_04",
			"ListItem_05", "ListItem_06", "ListItem_07", "ListItem_08","ListItem_09", 
			"ListItem_10", "ListItem_11", "ListItem_12", "ListItem_13", "ListItem_14", 
			"ListItem_15", "ListItem_16", "ListItem_17", "ListItem_18", "ListItem_19" };
	int i=0,j=20;
	
	/**刷新模式，
	 * 包括{
	 * 1.DISABLED(0x0)  			禁止通過手勢和手動執行
	 * 2.PULL_FROM_START(0x1)		可執行下拉刷新
	 * 3.PULL_FROM_END(0x2)			可執行上拉刷新
	 * 3.BOTH(0x3)					上下都可執行
	 * 4.MANUAL_REFRESH_ONLY(0x4)	禁止通過手勢執行，但可以手動設置
	 * }*/
	static final int MENU_SET_MODE = 2;
	
	/**這裏我們來判斷是下拉還是上拉*/
	private Mode CurrentMode;
	
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        initView();
        initData();
      /*  
       //監聽列表被刷新時事件
        mPullToRefreshListView.setOnRefreshListener(new OnRefreshListener<ListView>() {

			@Override
			public void onRefresh(PullToRefreshBase<ListView> refreshView) {
				 //設置下拉時顯示的日期和時間
				 String label=DateUtils.formatDateTime(getApplicationContext(), System.currentTimeMillis(), 
						 DateUtils.FORMAT_SHOW_TIME|DateUtils.FORMAT_SHOW_DATE|DateUtils.FORMAT_ABBREV_ALL);
				 // 更新顯示的label
				 mPullToRefreshListView.getLoadingLayoutProxy().setLastUpdatedLabel(label);
				
				 // 執行加載更多數據任務.
			    new GetDataTask().execute();
			}
		});*/
        
             
        
        mPullToRefreshListView.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener2<ListView>() {

			@Override
			public void onPullDownToRefresh(
					PullToRefreshBase<ListView> refreshView) {
				
				 //設置下拉時顯示的日期和時間
				 String label=DateUtils.formatDateTime(getApplicationContext(), System.currentTimeMillis(), 
						 DateUtils.FORMAT_SHOW_TIME|DateUtils.FORMAT_SHOW_DATE|DateUtils.FORMAT_ABBREV_ALL);
				 // 更新顯示的label
				 mPullToRefreshListView.getLoadingLayoutProxy().setLastUpdatedLabel(label);
				 CurrentMode=refreshView.getCurrentMode();
				 // 執行加載更多數據任務.
			    new GetDataTask().execute();
				
			}

			@Override
			public void onPullUpToRefresh(
					PullToRefreshBase<ListView> refreshView) {
								
				 //設置下拉時顯示的日期和時間
				 String label=DateUtils.formatDateTime(getApplicationContext(), System.currentTimeMillis(), 
						 DateUtils.FORMAT_SHOW_TIME|DateUtils.FORMAT_SHOW_DATE|DateUtils.FORMAT_ABBREV_ALL);
				 // 更新顯示的label
				 mPullToRefreshListView.getLoadingLayoutProxy().setLastUpdatedLabel(label);
				 CurrentMode=refreshView.getCurrentMode();
				 // 執行加載更多數據任務.
			    new GetDataTask().execute();
				
			}
		});
        
      //監聽滑動到底部的事件  
        mPullToRefreshListView.setOnLastItemVisibleListener(new OnLastItemVisibleListener() {

			@Override
			public void onLastItemVisible() {
				Toast.makeText(MainActivity.this,
						"已到列表底部!", Toast.LENGTH_SHORT).show();
				
			}
		});
        
    }
    public void initView(){
    	mPullToRefreshListView=(PullToRefreshListView) findViewById(R.id.pull_refresh_list);
    	//通過getRefreshableView()來得到一個listview對象
    	actualListView=mPullToRefreshListView.getRefreshableView();
    }
    /**
     * 設置listview的適配器
     */
    public void initData(){
    	listItems=new LinkedList<String>();
    	listItems.addAll(Arrays.asList(mStrings));
    	 //把string數組中的string添加到鏈表中
    	adapter=new ArrayAdapter<String>(this,android.R.layout.simple_list_item_1, listItems);
    	actualListView.setAdapter(adapter);
    }
    /**
     * @author:tuke
     * @tips  :通過異步任務來加載網絡中的數據，進行更新
     * 
     */
	private class GetDataTask extends AsyncTask<Void, Void, String[]> {

		@Override
		protected String[] doInBackground(Void... params) {
			try {
				Thread.sleep(3000);
			} catch (InterruptedException e) {
			}
			return mStrings;
		}

		@Override
		protected void onPostExecute(String[] result) {
			//這裏是提供給我們比較MODE的方法，返回0則表示相當
			if (CurrentMode.compareTo(Mode.PULL_FROM_START)==0) {
				listItems.addFirst("ListItem_"+--i);
			}else {
				listItems.addLast("ListItem_"+(j++));
			}
			
					
			adapter.notifyDataSetChanged();

			//當數據加載完成，需要調用onRefreshComplete.
			mPullToRefreshListView.onRefreshComplete();

			super.onPostExecute(result);
		}
	}
    @Override
    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.
        getMenuInflater().inflate(R.menu.main, menu);
        return true;
    }

    @Override
    public boolean onOptionsItemSelected(MenuItem item) {
        // Handle action bar item clicks here. The action bar will
        // automatically handle clicks on the Home/Up button, so long
        // as you specify a parent activity in AndroidManifest.xml.
        int id = item.getItemId();
        switch (id) {
		case R.id.pullfromstart:
			mPullToRefreshListView.setMode(Mode.PULL_FROM_START);
			break;
       case R.id.pullfromend:
    	   mPullToRefreshListView.setMode(Mode.PULL_FROM_END);
			break;
       case R.id.both:
    	    mPullToRefreshListView.setMode(Mode.BOTH);
	        break;
		default:
			break;
		}  
        
               
        return super.onOptionsItemSelected(item);
    }
}
說白了，重要的地方就是設置模式，和設置監聽器，
1，設置Mode
Java代碼 收藏代碼
PullToRefreshListView mListView = (PullToRefreshListView) findViewById(R.id.list_view); 
mListView.setMode(Mode.BOTH);
Mode.BOTH：同時支持上拉下拉
Mode.PULL_FROM_START：只支持下拉Pulling Down
Mode.PULL_FROM_END：只支持上拉Pulling Up


2，實現Listener
      如果Mode設置成Mode.BOTH，需要設置刷新Listener爲OnRefreshListener2，並實現onPullDownToRefresh()、onPullUpToRefresh()兩個方法。
     如果Mode設置成Mode.PULL_FROM_START或Mode.PULL_FROM_END，需要設置刷新Listener爲OnRefreshListener，同時實現onRefresh()方法。

     當然也可以設置爲OnRefreshListener2，但是Mode.PULL_FROM_START的時候只調用onPullDownToRefresh()方法，Mode.PULL_FROM的時候只調用onPullUpToRefresh()方法.



如果我們想改變下拉刷新的HeaderLayout的文字，文字顏色，背景，加載圖標怎麼辦？

1，在java代碼方法的設置：

可以在初始化完成mPullRefreshListView後，通過mPullRefreshListView.getLoadingLayoutProxy()可以得到一個ILoadingLayout對象，這個對象可以設置各種指示器中的樣式、文本等。


ILoadingLayout startLabels = mPullRefreshListView  
                .getLoadingLayoutProxy();  
        startLabels.setPullLabel("你可勁拉，拉...");// 剛下拉時，顯示的提示  
        startLabels.setRefreshingLabel("好嘞，正在刷新...");// 刷新時  
        startLabels.setReleaseLabel("你敢放，我就敢刷新...");// 下來達到一定距離時，顯示的提示

默認是上拉和下拉的字同時改變的，如果我希望單獨改變呢？

private void initIndicator()  
    {  
        ILoadingLayout startLabels = mPullRefreshListView  
                .getLoadingLayoutProxy(true, false);  
        startLabels.setPullLabel("你可勁拉，拉...");// 剛下拉時，顯示的提示  
        startLabels.setRefreshingLabel("好嘞，正在刷新...");// 刷新時  
        startLabels.setReleaseLabel("你敢放，我就敢刷新...");// 下來達到一定距離時，顯示的提示  
  
        ILoadingLayout endLabels = mPullRefreshListView.getLoadingLayoutProxy(  
                false, true);  
        endLabels.setPullLabel("你可勁拉，拉2...");// 剛下拉時，顯示的提示  
        endLabels.setRefreshingLabel("好嘞，正在刷新2...");// 刷新時  
        endLabels.setReleaseLabel("你敢放，我就敢刷新2...");// 下來達到一定距離時，顯示的提示  
    }
mPullRefreshListView.getLoadingLayoutProxy(true, false);接收兩個參數，爲true,false返回設置下拉的ILoadingLayout；爲false,true返回設置上拉的。
   2，library類工程中爲pulltorefresh提供了很多自定義屬性 





<?xml version="1.0" encoding="utf-8"?>
<resources>

    <declare-styleable name="PullToRefresh">

        <!-- A drawable to use as the background of the Refreshable View -->
        <!-- 設置刷新view的背景 -->
        <attr name="ptrRefreshableViewBackground" format="reference|color" />

        <!-- A drawable to use as the background of the Header and Footer Loading Views -->
        <!-- 設置頭部view的背景 -->
        <attr name="ptrHeaderBackground" format="reference|color" />

        <!-- Text Color of the Header and Footer Loading Views -->
        <!-- 設置頭部/底部文字的顏色 -->
        <attr name="ptrHeaderTextColor" format="reference|color" />

        <!-- Text Color of the Header and Footer Loading Views Sub Header -->
        <!-- 設置頭部/底部副標題的文字顏色 -->
        <attr name="ptrHeaderSubTextColor" format="reference|color" />

        <!-- Mode of Pull-to-Refresh that should be used -->
        <!-- 設置下拉刷新的模式，有多重方式可選。無刷新功能，從頂部刷新，從底部刷新，二者都有，只允許手動刷新 -->
        <attr name="ptrMode">
            <flag name="disabled" value="0x0" />
            <flag name="pullFromStart" value="0x1" />
            <flag name="pullFromEnd" value="0x2" />
            <flag name="both" value="0x3" />
            <flag name="manualOnly" value="0x4" />

            <!-- These last two are depreacted -->
            <!-- 這兩個屬性不推薦了，用上面的代替即可 -->
            <flag name="pullDownFromTop" value="0x1" />
            <flag name="pullUpFromBottom" value="0x2" />
        </attr>

        <!-- Whether the Indicator overlay(s) should be used -->
        <!-- 是否顯示指示箭頭 -->
        <attr name="ptrShowIndicator" format="reference|boolean" />

        <!-- Drawable to use as Loading Indicator. Changes both Header and Footer. -->
        <!-- 指示箭頭的圖片 -->
        <attr name="ptrDrawable" format="reference" />

        <!-- Drawable to use as Loading Indicator in the Header View. Overrides value set in ptrDrawable. -->
        <!-- 頂部指示箭頭的圖片，設置後會覆蓋ptrDrawable中頂部的設置 -->
        <attr name="ptrDrawableStart" format="reference" />

        <!-- Drawable to use as Loading Indicator in the Fooer View. Overrides value set in ptrDrawable. -->
        <!-- 底部指示箭頭的圖片，設置後會覆蓋ptrDrawable中底部的設置 -->
        <attr name="ptrDrawableEnd" format="reference" />

        <!-- Whether Android's built-in Over Scroll should be utilised for Pull-to-Refresh. -->
        <attr name="ptrOverScroll" format="reference|boolean" />

        <!-- Base text color, typeface, size, and style for Header and Footer Loading Views -->
        <!-- 設置文字的基本字體 -->
        <attr name="ptrHeaderTextAppearance" format="reference" />

        <!-- Base text color, typeface, size, and style for Header and Footer Loading Views Sub Header -->
        <!-- 設置副標題的基本字體 -->
        <attr name="ptrSubHeaderTextAppearance" format="reference" />

        <!-- Style of Animation should be used displayed when pulling. -->
        <!-- 設置下拉時標識圖的動畫，默認爲rotate -->
        <attr name="ptrAnimationStyle">
            <flag name="rotate" value="0x0" />
            <flag name="flip" value="0x1" />
        </attr>

        <!-- Whether the user can scroll while the View is Refreshing -->
        <!-- 設置刷新時是否允許滾動，一般爲true -->
        <attr name="ptrScrollingWhileRefreshingEnabled" format="reference|boolean" />

        <!--
            Whether PullToRefreshListView has it's extras enabled. This allows the user to be 
            able to scroll while refreshing, and behaves better. It acheives this by adding
            Header and/or Footer Views to the ListView.
        -->
        <!-- 允許在listview中添加頭/尾視圖 -->
        <attr name="ptrListViewExtrasEnabled" format="reference|boolean" />

        <!--
            Whether the Drawable should be continually rotated as you pull. This only
            takes effect when using the 'Rotate' Animation Style.
        -->
        <!-- 當設置rotate時，可以用這個來設置刷新時旋轉的圖片 -->
        <attr name="ptrRotateDrawableWhilePulling" format="reference|boolean" />

        <!-- BELOW HERE ARE DEPRECEATED. DO NOT USE. -->
        <attr name="ptrAdapterViewBackground" format="reference|color" />
        <attr name="ptrDrawableTop" format="reference" />
        <attr name="ptrDrawableBottom" format="reference" />
    </declare-styleable>

</resources>

ptrMode，ptrDrawable，ptrAnimationStyle這三個上面已經介紹過。
ptrRefreshableViewBackground 設置整個mPullRefreshListView的背景色
ptrHeaderBackground 設置下拉Header或者上拉Footer的背景色
ptrHeaderTextColor 用於設置Header與Footer中文本的顏色
ptrHeaderSubTextColor 用於設置Header與Footer中上次刷新時間的顏色
ptrShowIndicator如果爲true會在mPullRefreshListView中出現icon，右上角和右下角，挺有意思的。
ptrHeaderTextAppearance ， ptrSubHeaderTextAppearance分別設置拉Header或者上拉Footer中字體的類型顏色等等。
ptrRotateDrawableWhilePulling當動畫設置爲rotate時，下拉是是否旋轉。

看到有這麼多可以設置的屬性，別以爲真的就可以定製了。真正要定製還得到layout中改變刷新佈局

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >
    
    <com.handmark.pulltorefresh.library.PullToRefreshListView
         xmlns:ptr="http://schemas.android.com/apk/res-auto"  
        android:id="@+id/pull_refresh_list"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        ptr:ptrAnimationStyle="rotate"
        ptr:ptrHeaderTextColor="#000000"
        ptr:ptrHeaderSubTextColor="#00ffff"
        ptr:ptrHeaderBackground="@null"
        ptr:ptrDrawable="@drawable/android"  
        ptr:ptrMode="both"
     />
    
</LinearLayout>






發表評論
所有評論
還沒有人評論，想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章

真機測試webService提示http 403錯誤

原因：手機數據連接的方式爲：CMNET，切換爲CMWAP後正常，無線的話暫時還沒有測試，按理說沒問題； 參考資料：http://blog.csdn.net/lyq8479/article/details/6428288 

FairlyPerson 2020-07-07 15:57:52

Java泛型探索

1.關於泛型擦除 public class ErasedType { public static void main(String[] args) { Class c1 = new ArrayList<Integ

那棵树生气了_么 2020-07-07 05:57:49

Retrofit 下載apk，安裝時”解析錯誤“的問題原因。

我用retrofit+okhttp+rxjava，由於我加了日誌攔截器導致的。下載的時候不能用日誌攔截器。

xxx355200 2020-07-07 04:46:19

Android LocationListener 有的手機不能定位

業務需求，需要用定位，然後谷歌解析地址，發現有的手機定位很慢，有的無法定位。 調試的時候發現，onLocationChanged()方法根本沒有執行到。 定位慢沒找到原因。定位不上的切換一下手機系統語言就可以定位了。這是什麼情況？ 求大神

xxx355200 2020-07-07 04:46:19

第一章 Android開發簡介和常見控件介紹

1.Android開發簡介 1.1 搭建環境 環境：JDK(java development kit) + Android SDK(配置環境變量) 開發工具：AS + Genymotion + ADT(ada developme

w_jingjing0428 2020-07-06 22:48:12

Android學習筆記（18）---關於Activity全屏設置

先見代碼 1、主要在Activity裏面添加下面機會把屏幕最上面的titlebar隱藏 //隱藏titlebar,上面達到全屏 requestWindowFeature(Window.FEATURE_NO_TITLE);

Moruna 2020-07-06 12:02:40

Android學習筆記（25） --- 硬鍵盤+GridView選擇Item問題

1、這幾天要實現硬鍵盤選擇GridView中的Item來執行不同的操作，可糾結了幾天終不得解，摸索了很久也在網上找了很多資料。最後，終於有了眉目，基本實現了其功能。寫此文來總結一下。 2、首先是GridView數據的添加： gridvi

Moruna 2020-07-06 12:02:30

Android學習筆記（26） --- 動畫Animation使用

最近做個小應用需要用到動畫效果，組員已經實現了效果，拿過來修改下。 原理：動畫看起來的效果是圖片在移動，而且幾張圖片不停的在切換。 實現過程： 1、在res目錄下創建anim文件夾，創建myfish.xml,把幾張圖片的切換動畫設置好：

Moruna 2020-07-06 12:02:29

利用標籤來避免重複渲染

當你在Application中創建複雜的佈局時，頁面的渲染過程也變得更加緩慢。 此時，我們需要利用 <include />標籤(避免重複渲染)和 ViewStub類(延遲加載)來優化我們的頁面。 (原文地址：http://blog.csd

Eleven_ZY 2020-07-06 09:10:57

Android中手勢監聽GestureDetector基礎

最近做的2個東西中都碰到了需要對用戶手勢輸入監聽並做出一定的相應 抽空把這些基礎實現做個記錄 網上這方面資料也不少 這裏說的手勢監聽只是簡單的比如上滑，下滑，拖動等，而沒有說到畫圖板這樣的應用 當然舉一反三這個也是能實現的。 這裏分2

iteye_3848 2020-07-06 08:07:57

Android 同步歌詞滾動 唱片手勢滑動 原理手記

剛纔誤刪了一次。。。還好有個打開的頁面沒關掉 先上效果圖   中間就是同步滾動歌詞的部分了 現在是最簡單的效果 當前播放字體是紅色 其餘部分爲白色 右側是一個類似Gallery效果的 可以上下拖動 選擇唱片 擬3D 效果目前感覺還行

iteye_3848 2020-07-06 08:07:57

Mars視頻筆記——Oauth認證原理

想看一下AsyncTack的使用方法 記得寫過什麼 但是找了半天沒找到 才發現原來一直沒整理上來 關於Mars老師Android開發視頻教程第四季的一些東西（關於騰訊微博項目）   4-2 OAuth認證原理 1 什麼是OAuth

iteye_3848 2020-07-06 08:07:47

Mars視頻筆記——異步操作AsyncTask

  4-5 異步操作（一） 1 什麼是線程的阻塞 2 什麼是異步操作 3 AsyncTask的基本使用方法 申明一個類繼承AsyncTask 複寫doInBackground方法 在UI線程中調用asyncTask.excute()

iteye_3848 2020-07-06 08:07:47

CoordinatorLayout 之 AppBarLayout

實現效果： 隨着屏幕的滾動，Toolbar收縮 需要的庫： compile 'com.android.support:design:23.1.1' 需要使用的組件： android.support.design.widget.Coord

coder_______ 2020-07-04 22:09:34

開源項目PullToRefresh詳解

開源項地址：https://github.com/chrisbanes/Android-PullToRefresh 下拉刷新這個功能我們都比較常見了，今天介紹的就是這個功能的實現。我將按照這個開源庫的範例來一點一點介紹，今天是介紹比較

Cookie-kimi 2020-07-04 05:02:13