Zf_Pull_To_Refresh

继承自ViewGroup, PtrLayout控制Header和Conternt的布局，PtrLinearLayout 继承自PtrLayout，处理手势冲突和滑动，基本支持所有View。

PtrLinearLayout同时也支持自定义Header样式，下面详细介绍。

APK下载

• 下载地址
• 二维码下载

效果图

• AbsListView

• ViewPager

• ErrorView & EmptyView

使用方式

自定义属性

有3个参数可配置:

• ptr_resistance(下拉阻尼系数)

  默认: 2.0f，越大，感觉下拉时越吃力。

• ptr_ratio_refuse_requirement（执行刷新的最低高度和当前Header高度的比例）

  默认: 1.0f，比如，当前header高度是200px，但是我们希望下拉300px的时候才刷新，那么改参数值就是300/200=1.5f.

• ptr_duration_to_close_header(刷新完成后Header延迟多长时间在收起)

  默认：600ms，值越大，刷新完成后延迟时间越长。

  xml中配置示例

    <com.wzf.ptr.PtrLinearLayout
        android:id="@+id/container"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:ptr_duration_to_close_header="1000"
        app:ptr_ratio_refuse_requirement="1.5"
        app:ptr_resistance="2.5">

        <ListView
            android:id="@+id/listview"
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>

    </com.wzf.ptr.PtrLinearLayout>

Java代码设置

   ptrLinearLayout.setResistance(2.5f);
   ptrLinearLayout.setRatioOfHeaderHeightToRefresh(1.2f);
   ptrLinearLayout.setDurationCloseHeader(1000);

自定义Header

如果没有设置header，该库有个默认的Header类DefaultHeader，需要自定义Header时候，必须实现PtrHeader接口，并调用setHeader方法。

public interface PtrHeader {

    View getHeaderView(PtrLayout root);

    /**
     * 开始刷新
     *
     * @param view
     */
    void onBeginRefresh(PtrLinearLayout view);

    /**
     * 刷新完成
     *
     * @param view
     */
    void onCompleteRefuse(PtrLinearLayout view);

    void onResetHeader();

    /**
     * 改变高度时，满足刷新状态
     *
     * @param isRequireRefresh 是否满足刷新要求
     */
    void onPrepareRefreshToggle(boolean isRequireRefresh);

    /**
     * Header位置变化回调
     *
     * @param mHeaderHeight Header高度
     * @param mRefuseHeight 允许刷新的下拉高度
     * @param isTouch       是否触碰屏幕
     */
    void onPositionChange(int mHeaderHeight, int mRefuseHeight, int currentPosition, boolean isTouch);

具体示例可以参考DefaultHeader.java文件

自定义ErrorView和EmptyView

public interface PtrSpecialView {

    /**
     * 加载错误页面
     *
     * @param root
     * @return
     */
    View geErrorView(PtrLayout root);

    /**
     * 加载空数据页面
     *
     * @param root
     * @return
     */
    View geEmptyView(PtrLayout root);
}

自定义一个实现类，参考com.wzf.ptrdemos.PtrSpecialViews

 ptrLinearLayout.setPtrSpecialView(new PtrSpecialViews(this));

处理刷新

• 自动刷新

  ptrLinearLayout.refuse();

• 刷新回调

      // 触发下拉刷新
      ptrLinearLayout.setOnPtrListener(new OnPtrListener() {
            @Override
            public void onRefresh(final PtrLinearLayout view) {
                // 模拟业务处理延迟
                view.postDelayed(new Runnable() {
                    @Override
                    public void run() {
                        view.completeRefuse();
                    }
                }, 3000);
            }
        });

注意：

1. 刷新完成后必须调用 view.completeRefuse(); 以通知UI视图刷新。

2. 如果有设置过PtrSpecialView，那么必须在刷新后根据需求显示指定视图，如内容视图，错误视图和空视图分别调用showContentView(),showErrorView()和showEmptyView();如果未设置PtrSpecialView则不需要去调用以上3个方法，因为在如果有设置过PtrSpecialView的init()方法里已经默认加载了内容视图；具体示例可以参考demo。

3. showErrorView()和showEmptyView()方法有个多态方法，传递一个boolean值，若传递true，则在每次显示错误视图或空视图时都会调用PtrSpecialView中对应方法，具体可参考源码。

常见问题

• 处理ViewPager手势冲突，

 ptrLinearLayout.setEnableDisVerification(true);

联系方式和问题建议

E-mail: wangzf0342@qq.com

Blog: http://blog.csdn.net/coder_giser