当前位置: 代码迷 >> Android >> Android-PullToRefreshListView 的简略使用
  详细解决方案

Android-PullToRefreshListView 的简略使用

热度:77   发布时间:2016-04-27 22:36:42.0
Android--PullToRefreshListView 的简单使用

  原文:  http://blog.csdn.net/lmj623565791/article/details/38238749;

pull-to-refresh对ListView进行了封装,叫做:PullToRefreshListView,用法和listview没什么区别,下面看demo.

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:layout_width="match_parent"    android:layout_height="match_parent" >    <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"        android:cacheColorHint="#00000000"        android:divider="#19000000"        android:dividerHeight="4dp"        android:fadingEdge="none"        android:fastScrollEnabled="false"        android:footerDividersEnabled="false"        android:headerDividersEnabled="false"        android:smoothScrollbar="true" >    </com.handmark.pulltorefresh.library.PullToRefreshListView></RelativeLayout>
代码极其简单,得到PullToRefreshListView控件,然后像ListView一样设置数据集。当然了,我们有下拉刷新,所以必须设置下拉刷新的回调:

 

setOnRefreshListener(new OnRefreshListener<ListView>(){}

 // 设置监听事件          mPullRefreshListView                  .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);                            // 模拟加载任务                          new GetDataTask().execute();                      }                  });  

 

2、添加上拉加载更多

如过希望实现上拉加载更多,那么首先需要在布局文件的声明属性中添加一个属性,用于指定目前的下拉模式:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:layout_width="match_parent"    android:layout_height="match_parent" >    <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"        android:cacheColorHint="#00000000"        android:divider="#19000000"        android:dividerHeight="4dp"        android:fadingEdge="none"        android:fastScrollEnabled="false"        android:footerDividersEnabled="false"        android:headerDividersEnabled="false"        android:smoothScrollbar="true"        ptr:ptrMode="both" >    </com.handmark.pulltorefresh.library.PullToRefreshListView></RelativeLayout>

我们添加了一个属性:ptr:ptrMode="both" ,意思:上拉和下拉都支持。

可选值为:disabled(禁用下拉刷新),pullFromStart(仅支持下拉刷新),pullFromEnd(仅支持上拉刷新),both(二者都支持),manualOnly(只允许手动触发)

当然了,如果你不喜欢在布局文件中指定,完全可以使用代码设置,在onCreate里面写:mPullRefreshListView.setMode(Mode.BOTH);//设置你需要的模式

 

   mPullRefreshListView.setOnRefreshListener(new OnRefreshListener2<ListView>(){});注意这里的接口类型是OnRefreshListener2,多了个2,和上面的不一样,这个接口包含两个方法,一个上拉回调,一个下拉回调。好了,这样我们就成功添加了上拉与下拉,并且分别可以控制其回调代码。

mPullRefreshListView                  .setOnRefreshListener(new OnRefreshListener2<ListView>()                  {                      @Override                      public void onPullDownToRefresh(                              PullToRefreshBase<ListView> refreshView)                      {                          Log.e("TAG", "onPullDownToRefresh");                          //这里写下拉刷新的任务                          new GetDataTask().execute();                      }                        @Override                      public void onPullUpToRefresh(                              PullToRefreshBase<ListView> refreshView)                      {                          Log.e("TAG", "onPullUpToRefresh");                          //这里写上拉加载更多的任务                          new GetDataTask().execute();                      }                  });  

 

3、设置下拉刷新的图标

 <com.handmark.pulltorefresh.library.PullToRefreshGridView        ptr:ptrDrawable="@drawable/ic_launcher"        ...        />

当然了这是旋转的效果,一般常用的还有,一个箭头倒置的效果,其实也很简单,一个属性:

ptr:ptrAnimationStyle="flip"

去掉 ptr:ptrDrawable="@drawable/ic_launcher"这个属性,如果你希望用下图默认的箭头,你也可以自定义。

ptr:ptrAnimationStyle的取值:flip(翻转动画), rotate(旋转动画) 。 

ptr:ptrDrawable则就是设置图标了。

  

4、自定义下拉指示器文本内容等效果

可以在初始化完成mPullRefreshListView后,通过mPullRefreshListView.getLoadingLayoutProxy()可以得到一个ILoadingLayout对象,这个对象可以设置各种指示器中的样式、文本等。

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

 设置上次刷新时间:

String label = DateUtils.formatDateTime(                                  getApplicationContext(),                                  System.currentTimeMillis(),                                  DateUtils.FORMAT_SHOW_TIME                                          | DateUtils.FORMAT_SHOW_DATE                                          | DateUtils.FORMAT_ABBREV_ALL);                            // Update the LastUpdatedLabel                          refreshView.getLoadingLayoutProxy()                                  .setLastUpdatedLabel(label);  
5、常用的一些属性

当然了,pull-to-refresh在xml中还能定义一些属性:

ptrMode,ptrDrawable,ptrAnimationStyle这三个上面已经介绍过。

ptrRefreshableViewBackground 设置整个mPullRefreshListView的背景色

ptrHeaderBackground 设置下拉Header或者上拉Footer的背景色

ptrHeaderTextColor 用于设置Header与Footer中文本的颜色

ptrHeaderSubTextColor 用于设置Header与Footer中上次刷新时间的颜色

ptrShowIndicator如果为true会在mPullRefreshListView中出现icon,右上角和右下角,挺有意思的。

ptrHeaderTextAppearance , ptrSubHeaderTextAppearance分别设置拉Header或者上拉Footer中字体的类型颜色等等。

ptrRotateDrawableWhilePulling当动画设置为rotate时,下拉是是否旋转。

ptrScrollingWhileRefreshingEnabled刷新的时候,是否允许ListView或GridView滚动。觉得为true比较好。

ptrListViewExtrasEnabled 决定了Header,Footer以何种方式加入mPullRefreshListView,true为headView方式加入,就是滚动时刷新头部会一起滚动。

最后2个其实对于用户体验还是挺重要的,如果设置的时候考虑下~。其他的属性自己选择就好。

注:上述属性很多都可以代码控制,如果有需要可以直接mPullRefreshListView.set属性名 查看

以上为pull-to-refresh所有支持的属性~~

  相关解决方案