android Android-PullToRefresh 下拉刷新

1、github下载地址

原作者：  https://github.com/chrisbanes/Android-PullToRefresh

我自己的：  https://github.com/zyj1609wz/Android-PullToRefresh

2、使用方法

listview  布局文件

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context="com.example.aa.MainActivity"
    tools:ignore="MergeRootFrame" >

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        xmlns:ptr="http://schemas.android.com/apk/res-auto"
        android:id="@+id/listview"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:gravity="center"
        android:listSelector="#00000000"
        ptr:ptrMode="both" />

</LinearLayout>

常用的方法

package com.example.aa;
import java.util.ArrayList;
import java.util.List;
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.support.v7.app.ActionBarActivity;
import android.text.format.DateUtils;
import android.widget.ListView;
import android.widget.Toast;
import android.os.AsyncTask;
import android.os.Bundle;

public class MainActivity extends ActionBarActivity {
    PullToRefreshListView pullToRefreshListView  ;
    ListView listView  ;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        pullToRefreshListView = (PullToRefreshListView) findViewById( R.id.listview ) ;

        pullToRefreshListView.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 ) ; 

                //最后一次刷新的时间
                refreshView.getLoadingLayoutProxy().setLastUpdatedLabel( "上次刷新时间   " + label); 

                //设置刷新图标 下拉的时候显示的内容
                refreshView.getLoadingLayoutProxy().setLoadingDrawable(getResources().getDrawable( R.drawable.ic_launcher) );

                //下拉完成后，还没有刷新时 显示的内容
                refreshView.getLoadingLayoutProxy().setReleaseLabel( "默默地么么哒！！" );

                //松开手，正在刷新时 ，显示的内容
                refreshView.getLoadingLayoutProxy().setRefreshingLabel(  "啦啦啦啦啦" );

                Toast.makeText( MainActivity.this , "刷新了",  Toast.LENGTH_SHORT ).show();
                new GetDataTask().execute(  ) ;
            }
        });

        //listview 滑到 最后一项
        pullToRefreshListView.setOnLastItemVisibleListener( new OnLastItemVisibleListener() {
            @Override
            public void onLastItemVisible() {
                Toast.makeText( MainActivity.this , "listview到底了",  Toast.LENGTH_SHORT ).show() ;
            }
        });

        pullToRefreshListView.setMode( Mode.PULL_FROM_START );

        listView = pullToRefreshListView.getRefreshableView() ;

        listView.setAdapter( new Adapter( this , getData() ));

        /**
         * 程序进来就执行刷新数据，自动执行刷新
         */
        pullToRefreshListView.setRefreshing(); 

    }

    /**
     * @author admin
     *  pullToRefreshListView.onRefreshComplete();  这一句最好放在异步里面写
     *
     */
    private class GetDataTask extends AsyncTask<Void, Void, String> {
        @Override
        protected String doInBackground(Void... params) {
            try {
                Thread.sleep( 500 );
            } catch (InterruptedException e) {
            }
            return "" ;
        } 

        @Override
        protected void onPostExecute(String result) {
            super.onPostExecute(result);
            pullToRefreshListView.onRefreshComplete();
        }
    } 

    List<String> getData(){
        List<String> list = new ArrayList<String>() ;
        for( int i = 0 ; i < 100 ; i ++) {
            list.add( "ddd") ;
        }
        return list ;
    }

}

刷新模式

    //向下拉
    pullToRefreshListView.setMode( Mode.PULL_FROM_START );

    //向上拉
    pullToRefreshListView.setMode( Mode.PULL_FROM_END );

    //同时使用 下拉  和 上拉
    pullToRefreshListView.setMode( Mode.BOTH );

    /不启用刷新功能
    pullToRefreshListView.setMode( Mode.DISABLED );

获取当前的刷新模式

//获取当前的刷新模式
if( pullToRefreshListView.getMode() == Mode.BOTH ){
    Toast.makeText( MainActivity.this , "当前的刷新模式是 " + pullToRefreshListView.getMode() ,
                    Toast.LENGTH_SHORT ).show();
  }

设置刷新时的声音

         /**
         * Add Sound Event Listener
         */
        SoundPullEventListener<ListView> soundListener = new SoundPullEventListener<ListView>(this);
        soundListener.addSoundEvent(State.PULL_TO_REFRESH, R.raw.a1 );   //开始刷新显示的声音
        soundListener.addSoundEvent(State.RESET, R.raw.a2 );             //刷新完成后，显示的声音
        soundListener.addSoundEvent(State.REFRESHING, R.raw.a3 );        //正在刷新显示的声音
        pullToRefreshListView.setOnPullEventListener(soundListener);

设置 下拉刷新 和 上拉加载 更多 的监听方法

    pullToRefreshListView.setOnRefreshListener( new Refresh() ) ;

     /**
     * 监听方法
     * @author admin
     */
    class Refresh implements OnRefreshListener2<ListView> {
        //下拉
        @Override
        public void onPullDownToRefresh(PullToRefreshBase<ListView> refreshView) {

        }

        //上拉
        @Override
        public void onPullUpToRefresh(PullToRefreshBase<ListView> refreshView) {

        }
    }

设置正在刷新时，listview是否可以滚动

   //正在刷新的时候，listView 禁止滚动
   pullToRefreshListView.setScrollingWhileRefreshingEnabled( false );

   //正在刷新的时候，listView 可以滚动
    pullToRefreshListView.setScrollingWhileRefreshingEnabled( true );

设置刷新时显示的字体的颜色

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context="com.example.aa.MainActivity"
    tools:ignore="MergeRootFrame" >

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        xmlns:ptr="http://schemas.android.com/apk/res-auto"
        android:id="@+id/listview"
        android:background="#ffffff"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:gravity="center"
        android:listSelector="#00000000"
        ptr:ptrHeaderTextColor="#FF9900"
        ptr:ptrHeaderSubTextColor="#330099"
        ptr:ptrMode="both" />

    <!-- ptrHeaderTextColor   刷新提示显示的颜色 -->
    <!-- ptrHeaderSubTextColor 刷新提示子选项颜色值 -->

</LinearLayout>

运行结果

分别设置 下拉 和 上拉 显示的字体

        //得到下拉时候显示的ILoadingLayout
        ILoadingLayout startLayout = pullToRefreshListView.getLoadingLayoutProxy( true , false ) ;
        startLayout.setPullLabel("你可劲拉，拉...下拉");// 刚下拉时，显示的提示
        startLayout.setRefreshingLabel("好嘞，正在刷新...下拉");// 刷新时
        startLayout.setReleaseLabel("你敢放，我就敢刷新...下拉");// 下来达到一定距离时，显示的提示 

        //得到上拉时候显示的ILoadingLayout
        ILoadingLayout endLayout = pullToRefreshListView.getLoadingLayoutProxy( false , true  ) ;
        endLayout.setPullLabel("你可劲拉，拉... 上拉");// 刚下拉时，显示的提示
        endLayout.setRefreshingLabel("好嘞，正在刷新...上拉");// 刷新时
        endLayout.setReleaseLabel("你敢放，我就敢刷新...上拉");// 下来达到一定距离时，显示的提示 

常用的 xml 配置

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context="com.example.aa.MainActivity"
    tools:ignore="MergeRootFrame" >

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        xmlns:ptr="http://schemas.android.com/apk/res-auto"
        android:id="@+id/listview"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:background="#ffffff"
        android:gravity="center"
        android:listSelector="#00000000"
        ptr:ptrHeaderBackground="@drawable/background"
        ptr:ptrHeaderSubTextColor="#330099"
        ptr:ptrHeaderTextColor="#B26B00"
        ptr:ptrListViewExtrasEnabled="false"
        ptr:ptrMode="both"
        ptr:ptrRefreshableViewBackground="@drawable/b2"
        ptr:ptrRotateDrawableWhilePulling="false"
        ptr:ptrScrollingWhileRefreshingEnabled="true"
        ptr:ptrShowIndicator="true" />

    <!-- ptrHeaderTextColor   刷新提示显示的颜色 -->
    <!-- ptrHeaderSubTextColor 刷新提示子选项颜色值 -->
    <!-- ptr:ptrHeaderBackground 上拉背景图 -->
    <!-- ptrShowIndicator    右上角显示的小图标 -->
    <!-- ptrRefreshableViewBackground  整个listview的背景 -->
    <!-- ptrScrollingWhileRefreshingEnabled  刷新的时候，是否允许ListView或GridView滚动。觉得为true比较好。 -->
    <!-- ptrListViewExtrasEnabled  Footer以何种方式加入mPullRefreshListView，true为headView方式加入，就是滚动时刷新头部会一起滚动。 -->
    <!-- ptrRotateDrawableWhilePulling  当动画设置为rotate时，下拉是是否旋转。 -->

    <!-- ptr:ptrAnimationStyle  的取值：flip（翻转动画）， rotate（旋转动画） 。 -->
    <!-- ptr:ptrDrawable  则就是设置图标了。 -->

</LinearLayout>

运行结果

 3、不太常用的东西

1、如何 关闭 log 日志输出 ？

PullToRefresh 默认是开启日志输出的 。 在  PullToRefreshBase 里面可以看到 static final boolean DEBUG = true ;

true ： 输出日志 。   false : 不输出日志