当前位置: 代码迷 >> 综合 >> 4.5.3 ULtra Pull To Refresh
  详细解决方案

4.5.3 ULtra Pull To Refresh

热度:5   发布时间:2023-12-16 15:54:32.0

Ultra Pull To Refresh

  •  滚动视图 (ScrollView)
  •  ★★★★★
  •  2014-12-05 16:17
  •  1155 kb
  •  eclipse
  •  9825 次
  •  1052 次
  •  https://github.com/liaohuqiu/android-Ultra-Pull-To-Refresh
  • 下拉刷新
下载  收藏

liaohuqiu / android-Ultra-Pull-To-Refresh

Ultra Pull to Refresh for Android. Support all the views.

http://android-ultra-ptr.liaohuqiu.net/

介绍:

下拉刷新项目的替代方案。继承于ViewGroup可以包含任何View。功能比SwipeRefreshLayout强大。支持所有的View: ListView, GridView, ScrollView, FrameLayout, 甚至 TextView.

运行效果:

使用说明:

这是现在已经停止维护的下拉刷新项目的替代方案。继承于ViewGroup可以包含任何View。功能比SwipeRefreshLayout强大。

使用起来非常简单。良好的设计,如果你想定制自己的UI样式,非常简单,就像给ListView加一个Header View那么简单。

支持 API LEVEL >= 8

APK下载

  • 支持所有的View:

    ListView, GridView, ScrollView, FrameLayout, 甚至 TextView.

  • 支持各种下拉刷新交互.

    • 下拉刷新(iOS风格)

    • 释放刷新(经典风格)

    • 刷新时,头部保持(新浪微博)

    • 刷新时,头部不保持(微信朋友圈)

    • 自动刷新,进入界面时自动刷新

有6个参数可配置:

  • 阻尼系数

    默认: 1.7f,越大,感觉下拉时越吃力。

  • 触发刷新时移动的位置比例

    默认,1.2f,移动达到头部高度1.2倍时可触发刷新操作。

  • 回弹延时

    默认 200ms,回弹到刷新高度所用时间

  • 头部回弹时间

    默认1000ms

  • 刷新是保持头部

    默认值 true.

  • 下拉刷新 / 释放刷新

    默认为释放刷新

xml中配置示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
< in .srain.cube.views.ptr.PtrFrameLayout
     android:id= "@+id/store_house_ptr_frame"
     xmlns:cube_ptr= "http://schemas.android.com/apk/res-auto"
     android:layout_width= "match_parent"
     android:layout_height= "match_parent"
     cube_ptr:ptr_resistance= "1.7"
     cube_ptr:ptr_ratio_of_header_height_to_refresh= "1.2"
     cube_ptr:ptr_duration_to_close= "300"
     cube_ptr:ptr_duration_to_close_header= "2000"
     cube_ptr:ptr_keep_header_when_refresh= "true"
     cube_ptr:ptr_pull_to_fresh= "false"  >
     <LinearLayout
         android:id= "@+id/store_house_ptr_image_content"
         android:layout_width= "match_parent"
         android:layout_height= "match_parent"
         android:background= "@color/cube_mints_333333"
         android:clickable= "true"
         android:padding= "10dp" >
         < in .srain.cube.image.CubeImageView
             android:id= "@+id/store_house_ptr_image"
             android:layout_width= "match_parent"
             android:layout_height= "match_parent"  />
     </LinearLayout>
</ in .srain.cube.views.ptr.PtrFrameLayout>

也可以在java代码中配置

1
2
3
4
5
6
7
8
9
// the following are default settings
mPtrFrame.setResistance(1.7f);
mPtrFrame.setRatioOfHeaderHeightToRefresh(1.2f);
mPtrFrame.setDurationToClose(200);
mPtrFrame.setDurationToCloseHeader(1000);
// default is false
mPtrFrame.setPullToRefresh( false );
// default is true
mPtrFrame.setKeepHeaderWhenRefresh( true );

StoreHouse 风格

使用字符串, 支持A-Z, 0-7 以及 -.

1
2
3
4
5
6
7
8
// header
final StoreHouseHeader header =  new  StoreHouseHeader(getContext());
header.setPadding(0, LocalDisplay.dp2px(15), 0, 0);
/**
  * using a string, support: A-Z 0-9 - .
  * you can add more letters by {@link in.srain.cube.views.ptr.header.StoreHousePath#addChar}
  */
header.initWithString( 'Alibaba' );

使用资源文件中的路径信息

1
header.initWithStringArray(R.array.storehouse);

资源文件 res/values/arrays.xml 内容如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<resources>
     <string-array name= "storehouse" >
         <item>0,35,12,42,</item>
         <item>12,42,24,35,</item>
         <item>24,35,12,28,</item>
         <item>0,35,12,28,</item>
         <item>0,21,12,28,</item>
         <item>12,28,24,21,</item>
         <item>24,35,24,21,</item>
         <item>24,21,12,14,</item>
         <item>0,21,12,14,</item>
         <item>0,21,0,7,</item>
         <item>12,14,0,7,</item>
         <item>12,14,24,7,</item>
         <item>24,7,12,0,</item>
         <item>0,7,12,0,</item>
     </string-array>
</resources>

处理刷新


通过PtrHandler,可以检查确定是否可以下来刷新以及在合适的时间刷新数据。

检查是否可以下拉刷新在PtrDefaultHandler.checkContentCanBePulledDown中有默认简单的实现,你可以根据实际情况完成这个逻辑。


1
2
3
4
5
6
7
8
9
10
11
12
13
14
public interface PtrHandler {
     /**
      * 检查是否可以执行下来刷新,比如列表为空或者列表第一项在最上面时。
      * <p/>
      * {@link in.srain.cube.views.ptr.PtrDefaultHandler#checkContentCanBePulledDown}
      */
     public boolean checkCanDoRefresh(final PtrFrameLayout frame, final View content, final View header);
     /**
      * 需要加载数据时触发
      *
      * @param frame
      */
     public void onRefreshBegin(final PtrFrameLayout frame);
}

例子:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
ptrFrame.setPtrHandler( new  PtrHandler() {
     @Override
     public void onRefreshBegin(PtrFrameLayout frame) {
         frame.postDelayed( new  Runnable() {
             @Override
             public void run() {
                 ptrFrame.refreshComplete();
             }
         }, 1800);
     }
     @Override
     public boolean checkCanDoRefresh(PtrFrameLayout frame, View content, View header) {
         // 默认实现,根据实际情况做改动
         return  PtrDefaultHandler.checkContentCanBePulledDown(frame, content, header);
     }
});

  相关解决方案