【开源】Ultra Pull To Refresh

Ultra Pull To Refresh

• 项目地址： https://github.com/liaohuqiu/android-Ultra-Pull-To-Refresh

  介绍：

  下拉刷新项目的替代方案。继承于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中配置示例

  <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代码中配置

  // 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 以及 -.

  // 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');

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

  header.initWithStringArray(R.array.storehouse);

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

  <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中有默认简单的实现，你可以根据实际情况完成这个逻辑。

   

  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);
  }

  例子:

  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);
      }
  });

   

  相关代码

  • android-PullRefreshLayout
  • PullToRefreshAndLoad
  • Pull-to-Refresh.Rentals-Android
  • CRefreshLayout
  • PageAndPullToRefresh