Need help with android-Ultra-Pull-To-Refresh?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

liaohuqiu
9.7K Stars 2.8K Forks MIT License 182 Commits 172 Opened issues

Description

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

Services available

!
?

Need anything else?

Contributors list

Welcome to follow me on GitHub or Twitter

GitHub: https://github.com/liaohuqiu

Twitter: https://twitter.com/liaohuqiu


Build Status Android Arsenal

中文版文档

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

Ultra Pull To Refresh

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

Usage

Maven Central

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:

    in.srain.cube
    ultra-ptr
    aar
    
    
    1.0.11

pom.xml, stable version:

    in.srain.cube
    ultra-ptr
    aar
    
    
    1.0.11

gradle, latest version:

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

gradle, stable version:

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

Config

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.

Config in xml
<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"></in.srain.cube.image.cubeimageview>
</linearlayout>

</in.srain.cube.views.ptr.ptrframelayout>

Or config in java code

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

Other Config

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

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

StoreHouse Style

  • Config using string:
// 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');
  • Config using string array from xml:
header.initWithStringArray(R.array.storehouse);

And in

res/values/arrays.xml
:
  
      0,35,12,42,
      12,42,24,35,
      24,35,12,28,
      0,35,12,28,
      0,21,12,28,
      12,28,24,21,
      24,35,24,21,
      24,21,12,14,
      0,21,12,14,
      0,21,0,7,
      12,14,0,7,
      12,14,24,7,
      24,7,12,0,
      0,7,12,0,
  

Process Refresh

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

});

Customize

You can add a

PtrUIHandler
to
PtrFrameLayout
to implement any UI effect you want.
public interface PtrUIHandler {

/**
 * When the content view has reached top and refresh has been completed, view will be reset.
 *
 * @param frame
 */
public void onUIReset(PtrFrameLayout frame);

/**
 * prepare for loading
 *
 * @param frame
 */
public void onUIRefreshPrepare(PtrFrameLayout frame);

/**
 * perform refreshing UI
 */
public void onUIRefreshBegin(PtrFrameLayout frame);

/**
 * perform UI after refresh
 */
public void onUIRefreshComplete(PtrFrameLayout frame);

public void onUIPositionChange(PtrFrameLayout frame, boolean isUnderTouch, byte status, int oldPosition, int currentPosition, float oldPercent, float currentPercent);

}

Q & A

  • work with ViewPager:

    disableWhenHorizontalMove()
  • work with LongPressed,

    setInterceptEventWhileWorking()

Contact & Help

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
  1. 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/

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.