Android 下拉刷新相关库

Ultra Pull To Refresh


https://github.com/liaohuqiu/android-Ultra-Pull-To-Refresh 支持 API LEVEL >= 8

下拉刷新 + 加载更多?

本类库是单纯的下拉刷新。如果你需要用到加载更多,看这个项目: https://github.com/liaohuqiu/android-cube-app

  • 5.0 Material 风格 2014-12-09 新增。阴影效果,gif图看起来有些失真,看demo吧!
  • 支持所有的View: ListView, GridView, ScrollView, FrameLayout, 甚至 TextView.
  • 支持各种下拉刷新交互.
    • 下拉刷新(iOS风格)
    • 释放刷新(经典风格)
    • 刷新时,头部保持(新浪微博)
    • 刷新时,头部不保持(微信朋友圈)
    • 自动刷新,进入界面时自动刷新

    </div>

使用方式

中央库依赖

项目已经发布到了Maven中央库,包括aarapklib两种格式。在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()

gradle / Android Studio, 稳定版

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

配置

有6个参数可配置:

  • 阻尼系数 默认: 1.7f,越大,感觉下拉时越吃力。
  • 触发刷新时移动的位置比例 默认,1.2f,移动达到头部高度1.2倍时可触发刷新操作。
  • 回弹延时 默认 200ms,回弹到刷新高度所用时间
  • 头部回弹时间 默认1000ms
  • 刷新是保持头部 默认值 true.
  • 下拉刷新 / 释放刷新 默认为释放刷新
xml中配置示例
<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>

也可以在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 以及 - .
// 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');
  • 使用资源文件中的路径信息
header.initWithStringArray(R.array.storehouse);

资源文件 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>

处理刷新

通过PtrHandler,可以检查确定是否可以下来刷新以及在合适的时间刷新数据。

检查是否可以下拉刷新在PtrDefaultHandler.checkContentCanBePulledDown中有默认简单的实现,你可以根据实际情况完成这个逻辑。

public interface PtrHandler {

    /**
     * 检查是否可以执行下来刷新,比如列表为空或者列表第一项在最上面时。
     * <p/>
     * {@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);
}

例子:

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()

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏kevin-blog

学会如何让你在网络上变的相对匿名

因为最近在弄渗透测试,就担心那天被查水表了,就想起怎么让自己的变的相对匿名呢,这时我想到了tor,“Tor(The Onion Router)是第二代洋葱...

46010
来自专栏拂晓风起

cocos2d-js 调试办法 断点调试 Android真机调试

22920
来自专栏小白课代表

Autodesk Revit 2018安装教程

Revit是Autodesk公司一套系列软件的名称。Revit系列软件是专为建筑信息模型(BIM)构建的,可帮助建筑设计师设计、建造和维护质量更好、能效更高的建...

14120
来自专栏项勇

笔记57 | Android保持设备唤醒

22770
来自专栏FreeBuf

命令行下的“蒙面歌王”rundll32.exe

*本文原创作者:lcx,本文属FreeBuf原创奖励计划,未经许可禁止转载 ** 在Windows系统中,为了节省内存和实现代码重用,微软在Windows操作系...

28890
来自专栏逸鹏说道

SQL Server 2017 安装过程中的一点说明(有点意思)

偶尔冒个泡吧 会提到:“安装程序无法与下载服务器联系。请提供 Microsoft 机器学习服务器安装文件的位置,然后单击“下一步”。可从以下位置下载安装文件” ...

64660
来自专栏Android-JessYan

MVPArms MVP快速集成框架

原文地址: http://www.jianshu.com/p/48e66e879061

1.5K30
来自专栏Android源码框架分析

Android后台杀死系列之三:LowMemoryKiller原理(4.3-6.0)

本篇是Android后台杀死系列的第三篇,前面两篇已经对后台杀死注意事项,杀死恢复机制做了分析,本篇主要讲解的是Android后台杀死原理。相对于后台杀死恢复,...

22350
来自专栏Android开发指南

Android Training Note

37260
来自专栏DeveWork

让WordPress 在RSS 中Feed 输出支持“More”标签

如果你的主题支持“more”标签,在写文章的时候加上“more”标签,首页就可以截断显示。“more”标签截断文章的意义在于能够随心所欲,想断就断(汗,越写越废...

21950

扫码关注云+社区

领取腾讯云代金券