Android下拉刷新PtrFrameLayout的使用

Android下拉刷新PtrFrameLayout的使用

1.介紹:

• 可以包含所有的控件 :ListView, GridView, ScrollView, FrameLayout, 甚至 TextView.

• 可以自定義刷新頭(這點非常實用)

• 使用簡單方便

  不足就是不支持上拉加載.

2.使用

• 首先添加依賴到項目

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

• 在Xml中使用

  <in.srain.cube.views.ptr.PtrFrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/food_refreshLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:ptr_resistance="1.7"              //設置下拉的阻尼係數，值越大感覺越難下拉
    app:ptr_ratio_of_header_height_to_refresh="1.2"   //設置超過頭部的多少時，釋放可以執行刷新操作
    app:ptr_duration_to_close="200"               //：設置下拉回彈的時間
    app:ptr_duration_to_close_header="300"   //設刷新完成，頭部回彈時間，注意和前一個進行區別
    app:ptr_keep_header_when_refresh="true"   //設置刷新的時候是否保持頭部
    app:ptr_pull_to_fresh="false">        //設置下拉過程中執行刷新，我們一般設置爲false
  
    <ScrollView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
      >
      </ScrollView>
  
  </in.srain.cube.views.ptr.PtrFrameLayout>
  

• 在代碼中使用

  在代碼中使用非常簡單,簡單幾部搞定:

  1.找到控件,添加頭部刷新佈局

  mFoodRefreshLayout = (PtrFrameLayout) findViewById(R.id.food_refreshLayout);
  //這裏是一個自定義的頭部刷新佈局,自帶的也有一個佈局   new PtrDefaultHandler(); 
  PtrClassicHeader header = new PtrClassicHeader(this); 
  //將頭佈局添加
  mFoodRefreshLayout.addPtrUIHandler(header);

  2.不僅僅是添加頭佈局,還需要設置到控件中 注:特別重要,不然沒顯示

  mFoodRefreshLayout.setHeaderView(header); //設置刷新頭佈局

  3.給刷新控件設置下拉監聽

  mFoodRefreshLayout.setPtrHandler(new PtrHandler() {
    @Override
    public void onRefreshBegin(PtrFrameLayout frame) {
      //在這裏寫自己下拉刷新數據的請求
      //需要結束刷新頭
        mFoodRefreshLayout.refreshComplete();
    }
  
    @Override
    public boolean checkCanDoRefresh(PtrFrameLayout frame, View content, View header) {
        // 默認實現，根據實際情況做改動
        return PtrDefaultHandler.checkContentCanBePulledDown(frame, content, header);
    }
  });

3.自定義請求頭

​ 上面是對基本使用進行了介紹,相信大家在使用下拉刷新時都需要用到自定義佈局,其實也很簡單,在上面代碼添加刷新頭時就創建自定義的頭部即可,下面對自定義頭部的幾個方法做簡單介紹:

public class PtrClassicHeader extends FrameLayout  implements PtrUIHandler{  //實現接口
    private ImageView mPush;
    //在代碼創建對象
    public PtrClassicHeader(Context context) {
        super(context);
        initView();   
    }
    public PtrClassicHeader(Context context, AttributeSet attrs) {
        super(context, attrs);
        initView();
    }
    public PtrClassicHeader(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        initView();
    }

    //初始化自定義佈局文件
    private void initView() {
    //這裏加載自定義的佈局文件
    View header =   LayoutInflater.from(getContext()).inflate(R.layout.item_push_header_layout, this);
    //找到佈局內部的控件
        mPush = (ImageView) header.findViewById(R.id.header_iv);
    }

    //定義一個動畫,方便下面的調用
   public void  initAnim(){
       ObjectAnimator anim = ObjectAnimator.ofFloat(mPush, "rotation", 0f, 180f);
       anim.setDuration(500);
       anim.start();

   }
    //初始化狀態
    @Override
    public void onUIReset(PtrFrameLayout frame) {
        //這個方法可以不用管   也可以在這裏關閉動畫
    }

    //開始向下拉的時候調用
    @Override
    public void onUIRefreshPrepare(PtrFrameLayout frame) {
            initAnim();  //這裏可以執行動畫效果
    }

    //刷新過程時調用
    @Override
    public void onUIRefreshBegin(PtrFrameLayout frame) {
            //可以不斷的改變動畫效果以及切換顯示的控件
            //判斷是否可以刷新 
        if (frame.isPullToRefresh()) {
            mTitleTextView.setText("釋放刷新");
        } else {
            mTitleTextView.setText("下拉加載");
        }
    }

    //刷新完成後調用,向上移動時調用
    @Override
    public void onUIRefreshComplete(PtrFrameLayout frame) {
        //可以不斷的改變動畫效果以及切換顯示的控件
         mTitleTextView.setText("加載中...");
        animationDrawable.stop();  //模擬動畫
        animationDrawable.start();
    }

    //重複下拉
    @Override
    public void onUIPositionChange(PtrFrameLayout frame, boolean isUnderTouch, byte status, PtrIndicator ptrIndicator) {
        //在同一次下拉中不斷向上向下移動,這裏可以不斷改變顯示效果
        //示例代碼:  可以當模板使用  
        final int mOffsetToRefresh = frame.getOffsetToRefresh();
        final int currentPos = ptrIndicator.getCurrentPosY();  //獲取到下拉的高度
        final int lastPos = ptrIndicator.getLastPosY();      //最大下拉的高度
        //根據下拉的位置進行控件的顯示
        if (currentPos < mOffsetToRefresh && lastPos >= mOffsetToRefresh) {
            if (isUnderTouch && status == PtrFrameLayout.PTR_STATUS_PREPARE) {
                crossRotateLineFromBottomUnderTouch(frame); //調用方法
            }
        } else if (currentPos > mOffsetToRefresh && lastPos <= mOffsetToRefresh) {
            if (isUnderTouch && status == PtrFrameLayout.PTR_STATUS_PREPARE) {
                crossRotateLineFromTopUnderTouch(frame);  //調用方法
            }
        }
    }
    //下拉到可以刷新時顯示
    private void crossRotateLineFromTopUnderTouch(PtrFrameLayout frame) {
        if (!frame.isPullToRefresh()) {
            mTitleTextView.setText("釋放刷新");
        }
    }
    //動態改變文字
    private void crossRotateLineFromBottomUnderTouch(PtrFrameLayout frame) {
        if (frame.isPullToRefresh()) {
            mTitleTextView.setText("釋放刷新");
        } else {
            mTitleTextView.setText("下拉加載");
        }
    }
    }
}

4.解決衝突

ViewPager滑動衝突: 直接調用: disableWhenHorizontalMove()

如有不懂可查看:https://github.com/liaohuqiu/android-Ultra-Pull-To-Refresh/blob/master/README-cn.md