GitHub: https://github.com/liaohuqiu

Twitter: https://twitter.com/liaohuqiu

Wanna auto-load-more? This will be what you want: https://github.com/liaohuqiu/android-cube-app

It's a replacement for the deprecated pull to refresh solution. It can contain any view you want.

It's easy to use and more powerful than SwipeRefreshLayout.

It's well designed, you can customize the UI effect you want as easy as adding a headview to ListView.

Support API LEVEL >= 8, all snapshots are taken from Genymotion, 2.3.7.

Download APK

• StoreHouse Style first! Thanks to CBStoreHouseRefreshControl.

  

• Material Style, added @ 2014-12-09. There is a beautiful shadow which looks terrible in gif snapshot. Please Check out the DEMO.

  

• Supports all of the views: ListView, GridView, ScrollView, FrameLayout, or Even a single TextView.

  

• Supports all of the refresh types.

  • pull to refresh

    

  • release to refresh

    

  • keep header when refresh

    

  • hide header when refresh

    

  • auto refresh

    

This project has been pushed to Maven Central, both in aar and apklib.

The latest version: 1.0.11, has been published to: https://oss.sonatype.org/content/repositories/snapshots, in gradle:

maven{url 'https://oss.sonatype.org/content/repositories/snapshots' } 

The stable version: 1.0.11, https://oss.sonatype.org/content/repositories/releases, in gradle:

mavenCentral() 

pom.xml, latest version:

<dependency> <groupId>in.srain.cube</groupId> <artifactId>ultra-ptr</artifactId> <type>aar</type> <!-- or apklib format, if you want --><!-- <type>apklib</type> --> <version>1.0.11</version> </dependency>

pom.xml, stable version:

<dependency> <groupId>in.srain.cube</groupId> <artifactId>ultra-ptr</artifactId> <type>aar</type> <!-- or apklib format, if you want --><!-- <type>apklib</type> --> <version>1.0.11</version> </dependency>

gradle, latest version:

compile 'in.srain.cube:ultra-ptr:1.0.11' 

gradle, stable version:

compile 'in.srain.cube:ultra-ptr:1.0.11' 

There are 6 properties:

• Resistence

  This is the resistence while you are moving the frame, default is: 1.7f.

• Ratio of the Height of the Header to Refresh

  The ratio of the height of the header to trigger refresh, default is: 1.2f.

• Duration to Close

  The duration for moving from the position you relase the view to the height of header, default is 200ms.

• Duration to Close Header

  The default value is 1000ms

• Keep Header while Refreshing

  The default value is true.

• Pull to Refresh / Release to Refresh

  The default value is Release to Refresh.

<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" > <LinearLayoutandroid: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>

// the following are default settingsmPtrFrame.setResistance(1.7f); mPtrFrame.setRatioOfHeaderHeightToRefresh(1.2f); mPtrFrame.setDurationToClose(200); mPtrFrame.setDurationToCloseHeader(1000); // default is falsemPtrFrame.setPullToRefresh(false); // default is truemPtrFrame.setKeepHeaderWhenRefresh(true);

• setPinContent. Pin the content, only the HeaderView will be moved.

  This's the the performance of material style in support package v19.

• Config using string:

// headerfinalStoreHouseHeaderheader = newStoreHouseHeader(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');

• Config using string array from xml:

header.initWithStringArray(R.array.storehouse);

And in res/values/arrays.xml:

<resources> <string-arrayname="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>

There is a PtrHandler, by which you can refresh the data.

public interface PtrHandler{/** * Check can do refresh or not. For example the content is empty or the first child is in view. * <p/> *{@link in.srain.cube.views.ptr.PtrDefaultHandler#checkContentCanBePulledDown} */ public boolean checkCanDoRefresh(final PtrFrameLayout frame, final View content, final View header); /** * When refresh begin * * @param frame */ public void onRefreshBegin(final PtrFrameLayout frame)} 

An example:

ptrFrame.setPtrHandler(newPtrHandler(){@OverridepublicvoidonRefreshBegin(PtrFrameLayoutframe){frame.postDelayed(newRunnable(){@Overridepublicvoidrun(){ptrFrame.refreshComplete()} }, 1800)} @OverridepublicbooleancheckCanDoRefresh(PtrFrameLayoutframe, Viewcontent, Viewheader){returnPtrDefaultHandler.checkContentCanBePulledDown(frame, content, header)} });

You can add a PtrUIHandler to PtrFrameLayout to implement any UI effect you want.

publicinterfacePtrUIHandler{/** * When the content view has reached top and refresh has been completed, view will be reset. * * @param frame */publicvoidonUIReset(PtrFrameLayoutframe); /** * prepare for loading * * @param frame */publicvoidonUIRefreshPrepare(PtrFrameLayoutframe); /** * perform refreshing UI */publicvoidonUIRefreshBegin(PtrFrameLayoutframe); /** * perform UI after refresh */publicvoidonUIRefreshComplete(PtrFrameLayoutframe); publicvoidonUIPositionChange(PtrFrameLayoutframe, booleanisUnderTouch, bytestatus, intoldPosition, intcurrentPosition, floatoldPercent, floatcurrentPercent)}

• work with ViewPager: disableWhenHorizontalMove()

• work with LongPressed, setInterceptEventWhileWorking()

Please fell free to contact me if there is any problem when using the library.

• [email protected]

• twitter: https://twitter.com/liaohuqiu

• weibo: http://weibo.com/liaohuqiu

• blog: http://www.liaohuqiu.net

  1. About how to use cube-sdk / Ultra Ptr: 271918140 (cube-sdk)

     This the rule for our tribes, please read it before you request to join: https://github.com/liaohuqiu/qq-tribe-rule

  2. For those who like thinking independently and are good at solving problem independently. Please join us, we are all here on Slack:

     http://join-add1bit.liaohuqiu.net/