This is a modification of the Ultra-Pull-to-Refresh library which supports load-more for any view.
In order to add more features, I have separated some of configuration which was shared by header and footer before, like resistance and durationToClose. To avoid misunderstanding of variable and configuration names, there are some changes that you need to be aware.
- in the old version,
ptr_duration_to_closemeans the time to back to refreshing position when release and so as the functionsetDurationToClose. In the meanwhile,ptr_duration_to_close_headermeans the time to hide the header. This is a little bit confusing especially when add more features for footer. So, in the new version, there is noptr_duration_to_closebutptr_duration_to_back_refreshinstead. Also, the header and footer can separated byptr_duration_to_back_headerandptr_duration_to_back_footer. ptr_duration_to_close_eithermeans the time to back to start position (which is invisible) when refreshing completed.ptr_resistancecan also be separated byptr_resistance_headerandptr_resistance_footer.
Check the class FooterFeatures for some features I have added for footer. I'd like to receiver any feedback for improvement.
Ultra Pull to Refresh is 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.
It supports every view as well. All the logic is similar to the pull-to-refresh and the configurations(resistance, duration etc.) are shared for both load-more and pull-to-refresh. All the APIs for the origin branch are not modified. If you have used the origin Ultra-Pull-To-Refresh library, there will be no need to change your code if you move to this branch.
Currently, only the Home page（PtrDemoHomeFragment） and AutoRefresh（WithGridView） page in demo are modified to demonstrate how to use load-more.
Support API LEVEL >= 8, all snapshots are taken from Genymotion, 2.3.7.
setFooterView: Corresponding tosetHeaderView(). You may also need calladdPtrUIHandler()after setting the footer view, which is the same mechanism as setting header.PtrHandler2: A complementary ofPtrHandler. When using load more function, you should callsetPtrHandler(new PtrHandler2()), rather thansetPtrHandler(new PtrHandler()).PtrDefaultHandler2: Implemented a defaultcheckCanDoLoadMore()logic. The same mechanism asPtrDefaultHandler.PtrClassicDefaultFooter: Serve as a default footer which is the reverse of the default header.setMode(Mode): The mode is a new feature of this library. By usingsetMode, you can enable or disable either header or footer. The argument is an enum, you should it likesetMode(Mode.BOTH).
- in gradle:
compile 'in.srain.cube:ptr-load-more:1.0.6'
- in maven：
<dependency>
<groupId>in.srain.cube</groupId>
<artifactId>ptr-load-more</artifactId>
<version>1.0.6</version>
<type>pom</type>
</dependency>
- Github: https://github.com/captainbupt
- Email: [email protected]
If there is any suggestions or problems, please feel no hesitated to open an issue. I will keep responsing.
-
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" >
<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>// 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);-
setPinContent. Pin the content, only theHeaderViewwill be moved.This's the the performance of material style in support package v19.
- 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:
<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>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(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);
}
});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);
}-
work with ViewPager:
disableWhenHorizontalMove() -
work with LongPressed,
setInterceptEventWhileWorking()
Please fell free to contact me if there is any problem when using the library.
-
twitter: https://twitter.com/liaohuqiu
-
weibo: http://weibo.com/liaohuqiu
-
blog: http://www.liaohuqiu.net
-
QQ tribe: this the rule for our tribes, please read it before you request to join: https://github.com/liaohuqiu/qq-tribe-rule
- About how to use cube-sdk / Ultra Ptr: 271918140 (cube-sdk)
- For those who like thinking independently and are good at solving problem independently. Please join us, we are all here: 417208555 (cube-sdk-adv)
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent