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