SwipeDismissBehavior用法及实现原理

jopen 8年前

无意间发现design兼容库中有一个叫做SwipeDismissBehavior的类,顾名思义它就是用来实现滑动删除的了。莫非现在滑动删除又有更简单的解决办法了?鉴于之前RecyclerView中已经有ItemTouchHelper,而且也非常简单,这个意外发现真的让我很好奇,于是决定研究研究,看看它的实现原理以及应用场景:真的能替代其他的(不管是第三方还是RecyclerView自带的ItemTouchHelper)滑动删除吗?。

很不幸SwipeDismissBehavior现在的文档还很少,只有stackoverfolw上有点价值的讨论。

先来直接从API的角度使用SwipeDismissBehavior,然后再讲解SwipeDismissBehavior的原理。从而说明为什么SwipeDismissBehavior只能和CoordinatorLayout一起使用?为什么SwipeDismissBehavior对CoordinatorLayout中RecyclerView的item不起作用。

SwipeDismissBehavior的用法

SwipeDismissBehavior的用法非常简单。

第一步:引入design库:

compile 'com.android.support:appcompat-v7:23.1.0'  compile 'com.android.support:design:23+'

第二步:把要滑动删除的View放在CoordinatorLayout中:

xml代码:

<?xml version="1.0" encoding="utf-8"?>  <android.support.design.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"   xmlns:app="http://schemas.android.com/apk/res-auto"   xmlns:tools="http://schemas.android.com/tools"   android:id="@+id/coordinatorLayout"   android:layout_width="match_parent"   android:layout_height="match_parent"   >   <TextView    android:id="@+id/swip"    android:layout_width="match_parent"    android:layout_height="200dip"    android:background="#32CD32"    android:text="别删我"    android:textSize="20dip"    android:gravity="center"    />  </android.support.design.widget.CoordinatorLayout>

第三步:在MainActivity中为View设置一个SwipeDismissBehavior对象:

package com.jcodecraeer.swipedismissbehaviordemo;  import android.os.Bundle;  import android.support.design.widget.CoordinatorLayout;  import android.support.design.widget.SwipeDismissBehavior;  import android.support.v7.app.AppCompatActivity;  import android.view.View;  import android.widget.TextView;  public class MainActivity extends AppCompatActivity {      @Override      protected void onCreate(Bundle savedInstanceState) {   super.onCreate(savedInstanceState);   setContentView(R.layout.activity_main);   TextView swipeView = (TextView)findViewById(R.id.swip);   final SwipeDismissBehavior<View> swipe    = new SwipeDismissBehavior();   swipe.setSwipeDirection(    SwipeDismissBehavior.SWIPE_DIRECTION_ANY);   swipe.setListener(    new SwipeDismissBehavior.OnDismissListener() {        @Override public void onDismiss(View view) {        }        @Override        public void onDragStateChanged(int state) {}    });   CoordinatorLayout.LayoutParams coordinatorParams =    (CoordinatorLayout.LayoutParams) swipeView.getLayoutParams();   coordinatorParams.setBehavior(swipe);      }  }

其中

swipe.setListener(          new SwipeDismissBehavior.OnDismissListener() {              @Override public void onDismiss(View view) {                }                @Override              public void onDragStateChanged(int state) {}          });

都可以去掉。

然后运行就能得到如下效果:

SwipeDismissBehavior用法及实现原理

CoordinatorLayout与Behavior

SwipeDismissBehavior是design兼容库中的一个类。

定义

 public class SwipeDismissBehavior<V extends View> extends CoordinatorLayout.Behavior<V>

从这个定义可以看出SwipeDismissBehavior继承自CoordinatorLayout.Behavior。

而Behavior是CoordinatorLayout的一个内部类

public static abstract class Behavior<V extends View>

它只定义了一些抽象方法,其中最主要的当属下面两个(与本文相关):

public boolean onInterceptTouchEvent(CoordinatorLayout parent, V child, MotionEvent ev) {      return false;  }    public boolean onTouchEvent(CoordinatorLayout parent, V child, MotionEvent ev) {      return false;  }

CoordinatorLayout会在自己的onInterceptTouchEvent()方法中调用Behavior的

onInterceptTouchEvent:

b.onInterceptTouchEvent(this, child, ev);

把自己(this)、与此Behavior对象相关的子view(child)以及MotionEvent ev传递过去。这三个参数对于实现一个Behavior都至关重要。

CoordinatorLayout遍历子view,判断子view的mLayoutParam变量中是否有Behavior成员,如果有则调用Behavior的onInterceptTouchEvent和onTouchEvent方法。上面的代码中,swipeView通过

CoordinatorLayout.LayoutParams coordinatorParams =          (CoordinatorLayout.LayoutParams) swipeView.getLayoutParams();    coordinatorParams.setBehavior(swipe);

给自己设置了一个类型为SwipeDismissBehavior的Behavior,而且它又是CoordinatorLayout的子view,因此当CoordinatorLayout遍历到了这个cardview的时候,会尝试从这个swipeView获得Behavior:

final LayoutParams lp = (LayoutParams) child.getLayoutParams();  final Behavior b = lp.getBehavior();

注:这里的LayoutParams是CoordinatorLayout.LayoutParams类,跟ViewGroup的还是有所区别,他是CoordinatorLayout的内部类。其实任何一个布局比如LinearLayout都有自己的LayoutParams类型,也都是定义在布局类的内部。

如果检测到这个Behavior不为空,就调用它的onInterceptTouchEvent和onTouchEvent方法。

if (!intercepted && b != null) {   switch (type) {    case TYPE_ON_INTERCEPT:     intercepted = b.onInterceptTouchEvent(this, child, ev);     break;    case TYPE_ON_TOUCH:     intercepted = b.onTouchEvent(this, child, ev);     break;   }   if (intercepted) {    mBehaviorTouchView = child;   }  }

自此CoordinatorLayout的任务完成,因为我们设置的这个Behavior是SwipeDismissBehavior对象,所以接下来该怎么处理就交给SwipeDismissBehavior了。

以上过程基本都在CoordinatorLayout的performIntercept(MotionEvent ev, final int type)方法里。

SwipeDismissBehavior

那么我们看看SwipeDismissBehavior的onInterceptTouchEvent和onTouchEvent方法到底做了什么呢?

public boolean onInterceptTouchEvent(CoordinatorLayout parent, V child, MotionEvent event) {   switch(MotionEventCompat.getActionMasked(event)) {   case 1:   case 3:    if(this.mIgnoreEvents) {     this.mIgnoreEvents = false;     return false;    }    break;   default:    this.mIgnoreEvents = !parent.isPointInChildBounds(child, (int)event.getX(), (int)event.getY());   }   if(this.mIgnoreEvents) {    return false;   } else {    this.ensureViewDragHelper(parent);    return this.mViewDragHelper.shouldInterceptTouchEvent(event);   }  }  public boolean onTouchEvent(CoordinatorLayout parent, V child, MotionEvent event) {   if(this.mViewDragHelper != null) {    this.mViewDragHelper.processTouchEvent(event);    return true;   } else {    return false;   }  }

在onInterceptTouchEvent(CoordinatorLayout parent, V child, MotionEvent event) 中,调用了ensureViewDragHelper(parent):

private void ensureViewDragHelper(ViewGroup parent) {      if(this.mViewDragHelper == null) {          this.mViewDragHelper = this.mSensitivitySet?ViewDragHelper.create(parent, this.mSensitivity, this.mDragCallback):ViewDragHelper.create(parent, this.mDragCallback);      }    }

可以看到这里其实是用parent参数创建了一个ViewDragHelper,根据前面的分析,这里的parent其实就是CoordinatorLayout对象。如果你熟悉ViewDragHelper,那么基本上都能猜到SwipeDismissBehavior要做些什么了。

SwipeDismissBehavior就是根据 MotionEvent和parent创建了一个实现了滑动删除的ViewDragHelper。

具体实现的代码请看SwipeDismissBehavior的mDragCallback变量。

private final Callback mDragCallback = new Callback() {   private int mOriginalCapturedViewLeft;   public boolean tryCaptureView(View child, int pointerId) {    this.mOriginalCapturedViewLeft = child.getLeft();    return true;   }   public void onViewDragStateChanged(int state) {    if(SwipeDismissBehavior.this.mListener != null) {     SwipeDismissBehavior.this.mListener.onDragStateChanged(state);    }   }   public void onViewReleased(View child, float xvel, float yvel) {    int childWidth = child.getWidth();    boolean dismiss = false;    int targetLeft;    if(this.shouldDismiss(child, xvel)) {     targetLeft = child.getLeft() < this.mOriginalCapturedViewLeft?this.mOriginalCapturedViewLeft - childWidth:this.mOriginalCapturedViewLeft + childWidth;     dismiss = true;    } else {     targetLeft = this.mOriginalCapturedViewLeft;    }    if(SwipeDismissBehavior.this.mViewDragHelper.settleCapturedViewAt(targetLeft, child.getTop())) {     ViewCompat.postOnAnimation(child, SwipeDismissBehavior.this.new SettleRunnable(child, dismiss));    } else if(dismiss && SwipeDismissBehavior.this.mListener != null) {     SwipeDismissBehavior.this.mListener.onDismiss(child);    }   }   private boolean shouldDismiss(View child, float xvel) {    if(xvel != 0.0F) {     boolean distance1 = ViewCompat.getLayoutDirection(child) == 1;     return SwipeDismissBehavior.this.mSwipeDirection == 2?true:(SwipeDismissBehavior.this.mSwipeDirection == 0?(distance1?xvel < 0.0F:xvel > 0.0F):(SwipeDismissBehavior.this.mSwipeDirection == 1?(distance1?xvel > 0.0F:xvel < 0.0F):false));    } else {     int distance = child.getLeft() - this.mOriginalCapturedViewLeft;     int thresholdDistance = Math.round((float)child.getWidth() * SwipeDismissBehavior.this.mDragDismissThreshold);     return Math.abs(distance) >= thresholdDistance;    }   }   public int getViewHorizontalDragRange(View child) {    return child.getWidth();   }   public int clampViewPositionHorizontal(View child, int left, int dx) {    boolean isRtl = ViewCompat.getLayoutDirection(child) == 1;    int min;    int max;    if(SwipeDismissBehavior.this.mSwipeDirection == 0) {     if(isRtl) {      min = this.mOriginalCapturedViewLeft - child.getWidth();      max = this.mOriginalCapturedViewLeft;     } else {      min = this.mOriginalCapturedViewLeft;      max = this.mOriginalCapturedViewLeft + child.getWidth();     }    } else if(SwipeDismissBehavior.this.mSwipeDirection == 1) {     if(isRtl) {      min = this.mOriginalCapturedViewLeft;      max = this.mOriginalCapturedViewLeft + child.getWidth();     } else {      min = this.mOriginalCapturedViewLeft - child.getWidth();      max = this.mOriginalCapturedViewLeft;     }    } else {     min = this.mOriginalCapturedViewLeft - child.getWidth();     max = this.mOriginalCapturedViewLeft + child.getWidth();    }    return SwipeDismissBehavior.clamp(min, left, max);   }   public int clampViewPositionVertical(View child, int top, int dy) {    return child.getTop();   }   public void onViewPositionChanged(View child, int left, int top, int dx, int dy) {    float startAlphaDistance = (float)this.mOriginalCapturedViewLeft + (float)child.getWidth() * SwipeDismissBehavior.this.mAlphaStartSwipeDistance;    float endAlphaDistance = (float)this.mOriginalCapturedViewLeft + (float)child.getWidth() * SwipeDismissBehavior.this.mAlphaEndSwipeDistance;    if((float)left <= startAlphaDistance) {     ViewCompat.setAlpha(child, 1.0F);    } else if((float)left >= endAlphaDistance) {     ViewCompat.setAlpha(child, 0.0F);    } else {     float distance = SwipeDismissBehavior.fraction(startAlphaDistance, endAlphaDistance, (float)left);     ViewCompat.setAlpha(child, SwipeDismissBehavior.clamp(0.0F, 1.0F - distance, 1.0F));    }   }  };

问题

那么我们的问题来了?SwipeDismissBehavior可以替代RecyclerView的ItemTouchHelper或者其他列表滑动删除库吗?

答案是不能。

因为CoordinatorLayout遍历子View的时候,只遍历了第一层view,而列表的滑动删除对象是在RecyclerView的里面,不是CoordinatorLayout的直接子view。

再者,既然是RecyclerView的item,那么它的LayoutParams就是RecyclerView.LayoutParams 它无法强制转换成CoordinatorLayout.LayoutParams,所以运行的时候会报错:

java.lang.ClassCastException: android.support.v7.widget.RecyclerView$LayoutParams cannot be cast to android.support.design.widget.CoordinatorLayout$LayoutParams

因此SwipeDismissBehavior只适合本文开始的那种用法。