PullToRefreshListView 应用讲解

时间:2023-03-09 19:50:40
PullToRefreshListView 应用讲解

转载于http://blog.****.net/mmjiajia132/article/details/40397813

PullToRefreshListView 用法和ListView 没有什么区别  listview能用的属性 pulltorefresh也能用

我一直认为动手是最好的学习方法...

一:首先看布局文件

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  3. android:layout_width="match_parent"
  4. android:layout_height="match_parent"
  5. android:orientation="vertical" >
  6. <!--     ptr:ptrAnimationStyle="flip"  flip:翻转  rotate:旋转-->
  7. <!--     ptr:ptrShowIndicator="true"  右上角 右下角出现箭头-->
  8. <com.handmark.pulltorefresh.library.PullToRefreshListView
  9. xmlns:ptr="http://schemas.android.com/apk/res-auto"
  10. android:id="@+id/pullToRefresh"
  11. android:layout_width="match_parent"
  12. android:layout_height="wrap_content"
  13. ptr:ptrDrawable="@drawable/default_ptr_flip"
  14. ptr:ptrAnimationStyle="flip"
  15. ptr:ptrHeaderBackground="#383838"
  16. ptr:ptrHeaderTextColor="#FFFFFF"
  17. />
  18. </LinearLayout>

ptr是pullToRefresh的配置属性 使用是需要添加 xmlns:ptr="http://schemas.android.com/apk/res-auto"

ptr:ptrDrawable=“” 上拉下拉图标 ptr:ptrAnimationStyle=""  图标动画  取值: flip:翻转 rotate旋转 ptr:ptrHeaderBackground=""  上拉下拉时 头部的背景色 ptr:ptrHeaderTextColor=""     上拉下拉时 文字颜色

还有一些常用属性

ptrRefreshableViewBackground 设置整个mPullRefreshListView的背景色

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

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

注:上述属性都可以代码添加,请用pullToRefresh.set查看

二:MainActivity代码

  1. public class MainActivity extends ActionBarActivity {
  2. private PullToRefreshListView pullToRefresh;
  3. private List<PullBean> data = new ArrayList<PullBean>();
  4. MyAdapter adapter;
  5. @Override
  6. protected void onCreate(Bundle savedInstanceState) {
  7. super.onCreate(savedInstanceState);
  8. setContentView(R.layout.main);
  9. pullToRefresh = (PullToRefreshListView) findViewById(R.id.pullToRefresh);
  10. data = getData();
  11. adapter = new MyAdapter(this);
  12. pullToRefresh.setAdapter(adapter);
  13. /*
  14. * Mode.BOTH:同时支持上拉下拉
  15. * Mode.PULL_FROM_START:只支持下拉Pulling Down
  16. * Mode.PULL_FROM_END:只支持上拉Pulling Up
  17. */
  18. /*
  19. * 如果Mode设置成Mode.BOTH,需要设置刷新Listener为OnRefreshListener2,并实现onPullDownToRefresh()、onPullUpToRefresh()两个方法。
  20. * 如果Mode设置成Mode.PULL_FROM_START或Mode.PULL_FROM_END,需要设置刷新Listener为OnRefreshListener,同时实现onRefresh()方法。
  21. * 当然也可以设置为OnRefreshListener2,但是Mode.PULL_FROM_START的时候只调用onPullDownToRefresh()方法,
  22. * Mode.PULL_FROM的时候只调用onPullUpToRefresh()方法.
  23. */
  24. pullToRefresh.setMode(Mode.BOTH);
  25. init();
  26. /*
  27. * setOnRefreshListener(OnRefreshListener listener):设置刷新监听器;
  28. * setOnLastItemVisibleListener(OnLastItemVisibleListener listener):设置是否到底部监听器;
  29. * setOnPullEventListener(OnPullEventListener listener);设置事件监听器;
  30. * onRefreshComplete():设置刷新完成
  31. */
  32. /*
  33. * pulltorefresh.setOnScrollListener()
  34. */
  35. // SCROLL_STATE_TOUCH_SCROLL(1) 正在滚动
  36. // SCROLL_STATE_FLING(2) 手指做了抛的动作(手指离开屏幕前,用力滑了一下)
  37. // SCROLL_STATE_IDLE(0) 停止滚动
  38. /*
  39. * setOnLastItemVisibleListener
  40. * 当用户拉到底时调用
  41. */
  42. /*
  43. * setOnTouchListener是监控从点下鼠标 (可能拖动鼠标)到放开鼠标(鼠标可以换成手指)的整个过程 ,他的回调函数是onTouchEvent(MotionEvent event),
  44. * 然后通过判断event.getAction()是MotionEvent.ACTION_UP还是ACTION_DOWN还是ACTION_MOVE分别作不同行为。
  45. * setOnClickListener的监控时间只监控到手指ACTION_DOWN时发生的行为
  46. */
  47. pullToRefresh.setOnRefreshListener(new OnRefreshListener2<ListView>(){
  48. @Override
  49. public void onPullDownToRefresh(
  50. PullToRefreshBase<ListView> refreshView) {
  51. // TODO Auto-generated method stub
  52. PullBean bean = new PullBean();
  53. bean.setTitle("下拉刷新");
  54. bean.setContent("我的神");
  55. adapter.addFirst(bean);
  56. new FinishRefresh().execute();
  57. adapter.notifyDataSetChanged();
  58. }
  59. @Override
  60. public void onPullUpToRefresh(
  61. PullToRefreshBase<ListView> refreshView) {
  62. // TODO Auto-generated method stub
  63. PullBean bean = new PullBean();
  64. bean.setTitle("上拉刷新");
  65. bean.setContent("我的神");
  66. adapter.addLast(bean);
  67. new FinishRefresh().execute();
  68. adapter.notifyDataSetChanged();
  69. }
  70. });
  71. //      pullToRefresh.setOnRefreshListener(new OnRefreshListener<ListView>() {
  72. //
  73. //          @Override
  74. //          public void onRefresh(PullToRefreshBase<ListView> refreshView) {
  75. //              // TODO Auto-generated method stub
  76. //              String label = DateUtils.formatDateTime(getApplicationContext(), System.currentTimeMillis(),
  77. //                        DateUtils.FORMAT_SHOW_TIME | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_ABBREV_ALL);
  78. //
  79. //                // Update the LastUpdatedLabel
  80. //                refreshView.getLoadingLayoutProxy().setLastUpdatedLabel(label);
  81. //                PullBean bean = new PullBean();
  82. //                bean.setTitle("我的神");
  83. //                bean.setContent("我的神");
  84. //                adapter.addFirst(bean);
  85. //                new FinishRefresh().execute();
  86. //          }
  87. //
  88. //      });
  89. }
  90. private void init()
  91. {
  92. ILoadingLayout startLabels = pullToRefresh
  93. .getLoadingLayoutProxy(true, false);
  94. startLabels.setPullLabel("下拉刷新...");// 刚下拉时,显示的提示
  95. startLabels.setRefreshingLabel("正在载入...");// 刷新时
  96. startLabels.setReleaseLabel("放开刷新...");// 下来达到一定距离时,显示的提示
  97. ILoadingLayout endLabels = pullToRefresh.getLoadingLayoutProxy(
  98. false, true);
  99. endLabels.setPullLabel("上拉刷新...");// 刚下拉时,显示的提示
  100. endLabels.setRefreshingLabel("正在载入...");// 刷新时
  101. endLabels.setReleaseLabel("放开刷新...");// 下来达到一定距离时,显示的提示
  102. //      // 设置下拉刷新文本
  103. //      pullToRefresh.getLoadingLayoutProxy(false, true)
  104. //              .setPullLabel("上拉刷新...");
  105. //      pullToRefresh.getLoadingLayoutProxy(false, true).setReleaseLabel(
  106. //              "放开刷新...");
  107. //      pullToRefresh.getLoadingLayoutProxy(false, true).setRefreshingLabel(
  108. //              "正在加载...");
  109. //      // 设置上拉刷新文本
  110. //      pullToRefresh.getLoadingLayoutProxy(true, false)
  111. //              .setPullLabel("下拉刷新...");
  112. //      pullToRefresh.getLoadingLayoutProxy(true, false).setReleaseLabel(
  113. //              "放开刷新...");
  114. //      pullToRefresh.getLoadingLayoutProxy(true, false).setRefreshingLabel(
  115. //              "正在加载...");
  116. }
  117. private List<PullBean> getData(){
  118. List<PullBean> list = new ArrayList<PullBean>();
  119. for(int i = 0;i < 10;i ++){
  120. PullBean bean = new PullBean();
  121. bean.setTitle("item " + i + " 搜索业务增速下滑 Google廉颇老矣?");
  122. bean.setContent("Google于10月17日发布了2014年第三季度财报");
  123. list.add(bean);
  124. }
  125. return list;
  126. }
  127. private class FinishRefresh extends AsyncTask<Void, Void, Void>{
  128. @Override
  129. protected Void doInBackground(Void... params) {
  130. try {
  131. Thread.sleep(1000);
  132. } catch (InterruptedException e) {
  133. }
  134. return null;
  135. }
  136. @Override
  137. protected void onPostExecute(Void result){
  138. //          adapter.notifyDataSetChanged();
  139. pullToRefresh.onRefreshComplete();
  140. }
  141. }
  142. private class MyAdapter extends BaseAdapter{
  143. private LayoutInflater mInflater;
  144. public MyAdapter(Context context) {
  145. // TODO Auto-generated constructor stub
  146. mInflater = LayoutInflater.from(context);
  147. }
  148. public void addFirst(PullBean bean){
  149. data.add(0, bean);
  150. }
  151. public void addLast(PullBean bean){
  152. data.add(bean);
  153. }
  154. @Override
  155. public int getCount() {
  156. // TODO Auto-generated method stub
  157. return data.size();
  158. }
  159. @Override
  160. public Object getItem(int position) {
  161. // TODO Auto-generated method stub
  162. return data.get(position);
  163. }
  164. @Override
  165. public long getItemId(int position) {
  166. // TODO Auto-generated method stub
  167. return 0;
  168. }
  169. @Override
  170. public View getView(int position, View convertView, ViewGroup parent) {
  171. // TODO Auto-generated method stub
  172. ViewHolder viewHolder = null;
  173. if(convertView == null){
  174. viewHolder = new ViewHolder();
  175. convertView = mInflater.inflate(R.layout.item, null);
  176. viewHolder.title = (TextView) convertView.findViewById(R.id.title);
  177. viewHolder.content = (TextView) convertView.findViewById(R.id.content);
  178. convertView.setTag(viewHolder);
  179. }else{
  180. viewHolder = (ViewHolder) convertView.getTag();
  181. }
  182. viewHolder.title.setText(data.get(position).getTitle());
  183. viewHolder.content.setText(data.get(position).getContent());
  184. return convertView;
  185. }
  186. class ViewHolder{
  187. TextView title;
  188. TextView content;
  189. }
  190. }
  191. }

pullToRefresh适配器Adapter和listview也是继承于BaseAdapter 看一下item的布局

item.xml

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  3. android:layout_width="match_parent"
  4. android:layout_height="match_parent"
  5. android:padding="5dp"
  6. android:orientation="vertical" >
  7. <TextView
  8. android:id="@+id/title"
  9. android:layout_width="wrap_content"
  10. android:layout_height="wrap_content"
  11. android:textSize="18sp"
  12. android:textColor="#BA55D3"
  13. android:text="我的神"/>
  14. <TextView
  15. android:id="@+id/content"
  16. android:layout_width="wrap_content"
  17. android:layout_height="wrap_content"
  18. android:textSize="14.0sp"
  19. android:layout_marginTop="5dp"
  20. android:textColor="#7CFC00"
  21. android:text="我的神"/>
  22. </LinearLayout>

pullToRefresh 通过setMode来设置是否可以上拉下拉

Mode.BOTH:同时支持上拉下拉

Mode.PULL_FROM_START:只支持下拉Pulling Down

Mode.PULL_FROM_END:只支持上拉Pulling Up

也可以用 ptr:ptrMode="both"

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

如果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()方法.

如果想上拉、下拉刷新的时候 做一样的操作,那就用OnRefreshListener,上拉下拉的时候都调用

如果想上拉、下拉做不一样的的操作,那就在setOnRefreshListener时 用new OnRefreshListener2<ListView>

当然如果想自己设置上拉下拉中的文字 可以这样

  1. ILoadingLayout startLabels = pullToRefresh
  2. .getLoadingLayoutProxy(true, false);
  3. startLabels.setPullLabel("下拉刷新...");// 刚下拉时,显示的提示
  4. startLabels.setRefreshingLabel("正在载入...");// 刷新时
  5. startLabels.setReleaseLabel("放开刷新...");// 下来达到一定距离时,显示的提示
  6. ILoadingLayout endLabels = pullToRefresh.getLoadingLayoutProxy(
  7. false, true);
  8. endLabels.setPullLabel("上拉刷新...");// 刚下拉时,显示的提示
  9. endLabels.setRefreshingLabel("正在载入...");// 刷新时
  10. endLabels.setReleaseLabel("放开刷新...");// 下来达到一定距离时,显示的提示

当然也可以这样

  1. pullToRefresh.getLoadingLayoutProxy(false, true)
  2. .setPullLabel("上拉刷新...");
  3. pullToRefresh.getLoadingLayoutProxy(false, true).setReleaseLabel(
  4. "放开刷新...");
  5. pullToRefresh.getLoadingLayoutProxy(false, true).setRefreshingLabel(
  6. "正在加载...");
  7. // 设置上拉刷新文本
  8. pullToRefresh.getLoadingLayoutProxy(true, false)
  9. .setPullLabel("下拉刷新...");
  10. pullToRefresh.getLoadingLayoutProxy(true, false).setReleaseLabel(
  11. "放开刷新...");
  12. pullToRefresh.getLoadingLayoutProxy(true, false).setRefreshingLabel(
  13. "正在加载...");

显然在实际操作的时候也会用到其他监听

setOnScrollListener()

SCROLL_STATE_TOUCH_SCROLL 正在滚动      SCROLL_STATE_FLING 手指做了抛的动作(手指离开屏幕前,用力滑了一下)      SCROLL_STATE_IDLE 停止滚动

setOnLastItemVisibleListener

当用户拉到底时调用

setOnItemClickListener()

为pullToRefresh中每一个item设置事件

代码下载:点击下载代码

下拉上拉 图标和文字 位置改动是在PullToRefresh源代码中改的即:PullToRefreshListView.handleStyledAttributes 中lp的Gravity改为CENTER_VERTICAL

如果想要改动图标和文字的距离和布局 在这library项目下这两个文件改

pull_to_refresh_header_horizontal.xml

pull_to_refresh_header_vertical.xml

参考博客:

http://blog.****.net/lmj623565791/article/details/38238749

http://blog.****.net/harvic880925/article/details/17680305

谢谢原作者