Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/liaohuqiu/android-Ultra-Pull-To-Refresh
Ultra Pull to Refresh for Android. Support all the views.
https://github.com/liaohuqiu/android-Ultra-Pull-To-Refresh
Last synced: about 2 months ago
JSON representation
Ultra Pull to Refresh for Android. Support all the views.
- Host: GitHub
- URL: https://github.com/liaohuqiu/android-Ultra-Pull-To-Refresh
- Owner: liaohuqiu
- License: mit
- Created: 2014-11-13T03:13:10.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2023-05-28T15:12:24.000Z (over 1 year ago)
- Last Synced: 2024-10-15T18:41:48.900Z (about 2 months ago)
- Language: Java
- Homepage:
- Size: 3.31 MB
- Stars: 9,583
- Watchers: 439
- Forks: 2,654
- Open Issues: 172
-
Metadata Files:
- Readme: README-cn.md
- License: LICENSE
Awesome Lists containing this project
- -awesome-android-ui - Ultra Pull To Refresh - 2.0) | <img src="/art/android-Ultra-Pull-To-Refresh.gif" width="49%"> <img src="/art/android-Ultra-Pull-To-Refresh2.gif" width="49%"> <img src="/art/android-Ultra-Pull-To-Refresh3.gif" width="49%"> <img src="/art/android-Ultra-Pull-To-Refresh4.gif" width="49%"> (Index `(light-weight pages)`)
- awesome-android-ui - Ultra Pull To Refresh - 2.0) | <img src="/art/android-Ultra-Pull-To-Refresh.gif" width="49%"> <img src="/art/android-Ultra-Pull-To-Refresh2.gif" width="49%"> <img src="/art/android-Ultra-Pull-To-Refresh3.gif" width="49%"> <img src="/art/android-Ultra-Pull-To-Refresh4.gif" width="49%"> (Index `(light-weight pages)`)
- awesome-github-android-ui - android-Ultra-Pull-To-Refresh - 下拉刷新项目的替代方案 (下拉刷新)
- fucking-android-open-project - android-Ultra-Pull-to-Refresh
- awesome-android-ui - Ultra Pull To Refresh - 2.0) | <img src="/art/android-Ultra-Pull-To-Refresh.gif" width="49%"> <img src="/art/android-Ultra-Pull-To-Refresh2.gif" width="49%"> <img src="/art/android-Ultra-Pull-To-Refresh3.gif" width="49%"> <img src="/art/android-Ultra-Pull-To-Refresh4.gif" width="49%"> (Index)
README
###### 欢迎关注我
GitHub: https://github.com/liaohuqiu
微博: http://weibo.com/liaohuqiu
知乎: http://www.zhihu.com/people/liao-hu-qiu
---
# Ultra Pull To Refresh
这是现在已经停止维护的下拉刷新项目的替代方案。继承于ViewGroup可以包含任何View。功能比SwipeRefreshLayout强大。
使用起来非常简单。良好的设计,如果你想定制自己的UI样式,非常简单,就像给ListView加一个Header View那么简单。
支持 `API LEVEL >= 8`。
[APK下载](https://raw.githubusercontent.com/liaohuqiu/android-Ultra-Pull-To-Refresh/master/ptr-demo.apk)
#### 下拉刷新 + 加载更多?
本类库是单纯的下拉刷新。如果你需要用到`加载更多`,看这个项目: https://github.com/liaohuqiu/android-cube-app
#### 使用eclipse的同学请注意, Intellij IDEA / Android Studio 请忽略
**demo可以直接在eclipse中运行, 编译demo项目的同学看这里: http://www.liaohuqiu.net/cn/posts/compile-ultra-ptr-in-eclipse/**
* 先上两张StoreHouse风格的截图! 感谢 [CBStoreHouseRefreshControl](https://github.com/coolbeet/CBStoreHouseRefreshControl).
* 5.0 Material 风格 2014-12-09 新增。**阴影效果,gif图看起来有些失真,看demo吧!**
* **支持所有的View**:
ListView, GridView, ScrollView, FrameLayout, 甚至 TextView.
* 支持各种下拉刷新交互.
* 下拉刷新(iOS风格)
* 释放刷新(经典风格)
* 刷新时,头部保持(新浪微博)
* 刷新时,头部不保持(微信朋友圈)
* 自动刷新,进入界面时自动刷新
# 使用方式
#### 中央库依赖
项目已经发布到了Maven中央库,包括`aar`和`apklib`两种格式。在Maven或者Gradle下可如下直接引入:
最新版版本号: `1.0.11`, 发布到了: https://oss.sonatype.org/content/repositories/snapshots
在gradle中:
```
maven {
url 'https://oss.sonatype.org/content/repositories/snapshots'
}
```稳定版: `1.0.11`, https://oss.sonatype.org/content/repositories/releases, in gradle:
```
mavenCentral()
````pom.xml` 文件中
最新版:
```xml
in.srain.cube
ultra-ptr
aar
1.0.11稳定版
```xml
in.srain.cube
ultra-ptr
aar
1.0.11```
gradle / Android Studio, 最新版
```
compile 'in.srain.cube:ultra-ptr:1.0.11'
```gradle / Android Studio, 稳定版
```
compile 'in.srain.cube:ultra-ptr:1.0.11'
```#### 配置
有6个参数可配置:
* 阻尼系数
默认: `1.7f`,越大,感觉下拉时越吃力。
* 触发刷新时移动的位置比例
默认,`1.2f`,移动达到头部高度1.2倍时可触发刷新操作。
* 回弹延时
默认 `200ms`,回弹到刷新高度所用时间
* 头部回弹时间
默认`1000ms`
* 刷新是保持头部
默认值 `true`.
* 下拉刷新 / 释放刷新
默认为释放刷新
##### xml中配置示例
```xml
```
### 也可以在java代码中配置
```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);
```### 其他配置
* 刷新时,保持内容不动,仅头部下移, `setPinContent()`
`Material` 风格时,效果不错,其他风格的头部,效果不好。issue #29
## StoreHouse 风格
* 使用字符串, 支持A-Z, 0-7 以及 `-` `.`
```java
// 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');
```* 使用资源文件中的路径信息
```java
header.initWithStringArray(R.array.storehouse);
```资源文件 `res/values/arrays.xml` 内容如下:
```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,
```
# 处理刷新
通过`PtrHandler`,可以检查确定是否可以下来刷新以及在合适的时间刷新数据。
检查是否可以下拉刷新在`PtrDefaultHandler.checkContentCanBePulledDown`中有默认简单的实现,你可以根据实际情况完成这个逻辑。
```
public interface PtrHandler {/**
* 检查是否可以执行下来刷新,比如列表为空或者列表第一项在最上面时。
*
* {@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);
}
```例子:
```java
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);
}
});
```# 常见问题
* ViewPager滑动冲突: `disableWhenHorizontalMove()`
* 长按LongPressed, `setInterceptEventWhileWorking()`
# 联系方式和问题建议
* 微博: http://weibo.com/liaohuqiu
* QQ 群:1. cube系列开源项目使用交流,问题解答: 271918140 (cube-sdk)
加群前请先阅读群约定: https://github.com/liaohuqiu/qq-tribe-rule
2. 如果你会通过google解决问题,喜欢独立思考,喜欢和优秀却又温和的人成为朋友,欢迎加入我们在 Slack 上的群组: 我们在 Slack 上的群组:
http://join-add1bit.liaohuqiu.net/?channel=git-android-ultra-ptr* [email protected]
* twitter: https://twitter.com/liaohuqiu
* blog: http://www.liaohuqiu.net