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: 20 days ago
JSON representation

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

Lists

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