ViewDragHelper的使用
我19年一整年都没写过博客,说实话没写的欲望,现在找到了动机,因为我发现让我愿意研究的东西,很大一部分因为它有意思,没什么兴趣的知识,除非工作需要,真的不愿意碰。今天介绍的是viewdraghelper这个工具类。它在你自定义viewgroup时,帮你解决子view拖动、定位、状态跟踪。这是官方的解释,当然,我用大白话在复述一下:子view想要*飞翔,肯定得先经过父view的允许,而父view把做决定的权利全部交给了viewdraghelper。虽然这个helper类代码很长,有1500多行,但搞清楚了它开放给我们的几个回调,以及一丁点对事件分发的理解,就可以写出一个让你成就感满满的控件。今天的目标:写一个右滑就多出两个子view的控件(大约150行代码就行)。
这个例子是仿github上项目写的,原项目地址https://github.com/daimajia/androidswipelayout。当然这是精简版的,别人的代码总是望而生畏!viewdraghelper从拦截到处理事件的整个过程,只公布了一个回调类给我们使用,我们可以从其中选一些对我们有用的去实现,这里,我把我写这个控件实现的类列举出来:
public abstract boolean trycaptureview(@nonnull view child, int pointerid);
1.当你拖动子view,这个方法肯定是要实现的,而且必须返回true,表示你要捕获你拖动的子view,接下来它的位置信息、拖动速度等一系列参数才会被记录,并返回给你。
public int clampviewpositionhorizontal(@nonnull view child, int left, int dx) {return 0;}
2.前面提过,你捕获控件后,helper会返回给你一些数据,这个方法返回给你的就是控件水平位置信息。 重点理解left这个值。写来写去,就这个left值迷惑人!!!请慢慢品味下面这句话:以child父布局的左上角顶点为坐标原点,以右为x轴正方向,下为y轴正方向, left值等于child水平方向划过的像素数(从左往右,像素数为正,反之为负)与它自身的mleft值的和。撇开数值的结果,通俗的来讲就是你这次移动之后,child的水平位置应该在哪里!为什么是应该呢,因为这个方法走完,紧接着系统会拿该方法返回值作为view新的x坐标(即mleft值)。那么在系统告诉你view移动后,应该所处的位置与你最终返回的位置之间,你可以做边界判断。例如:子view初始位置mleft = 0,如果我将view向左滑动20px,那么此方法left就会返回给我-20,而我又不想拿这个值作为子view的新的x坐标。那我返回0,就可以让子view水平还在原位置。以下两个例子是left值的计算方法:
例子1:子view视图的左顶点就在父布局的坐标原点处,当你手指从左往右滑动10个像素,left就等于像素数+10 加上view距离坐标原点横坐标0,结果就是10;
例子2:父布局paddingleft 为20像素,如果单位是dp,最终也是转为px计算的。子view的mleft = 20,当你手指从右往左滑动10个像素,left就等于像素数-10+20=10;
left理解通透之后,dx就好说了,还记得刚提到的可正可负的像素数吗,哈哈,dx就是它!综上,可以得出一个公式:left = view.getleft()+dx.
3.clampviewpositionvertical和上一个方法就是双胞胎兄弟,这个我就不多介绍了。更多的文字留给更神秘的方法。
public void onviewpositionchanged(@nonnull view changedview, int left, int top, int dx, int dy)
4.这个方法的解释我觉得直接看源代码更好理解:
private void dragto(int left, int top, int dx, int dy) { int clampedx = left; int clampedy = top; final int oldleft = mcapturedview.getleft(); final int oldtop = mcapturedview.gettop(); if (dx != 0) { clampedx = mcallback.clampviewpositionhorizontal(mcapturedview, left, dx); viewcompat.offsetleftandright(mcapturedview, clampedx - oldleft); } if (dy != 0) { clampedy = mcallback.clampviewpositionvertical(mcapturedview, top, dy); viewcompat.offsettopandbottom(mcapturedview, clampedy - oldtop); } if (dx != 0 || dy != 0) { final int clampeddx = clampedx - oldleft; final int clampeddy = clampedy - oldtop; mcallback.onviewpositionchanged(mcapturedview, clampedx, clampedy, clampeddx, clampeddy); } }
当view被拖动,会调用这个dragto,这个方法将以上3个方法的执行顺序以及参数传递,描述的非常清楚,可以看到onviewpositionchanged()参数中的left,top分别是前两个方法返回给我们的,末尾的dx,dy对我们移动view也有用,待会可以看到。
public void onviewreleased(@nonnull view releasedchild, float xvel, float yvel) {
5.顾名思义,这个方法就是当我们手指离开view时调用的,xvel ,yvel分别是手指离开view时,view在x,y轴上的速度,这里的速度是指每秒划过的像素数。这个方法执行后,假如我们想让view恢复至初始位置,就可以在这里面调用,根据速度,我们可以做些速度判断,了解用户到底想不想滑动,还是匀速滑动,埋个伏笔,待会写控件时,这个方法里面可以做些文章。
public int getviewhorizontaldragrange(@nonnull view child) {}
6.这个函数的使用和子view的点击事件关联性很大,同时结合事件分发,才能完整的将子view的点击事件合理的处理,所以这个方法我在第二篇单独讲它的使用,现在你可以不重写它,今天主要目标,让我们的控件滑起来!
这几个回调函数介绍完,看看xml布局,我们继承水平的linearlayout去实现。
<com.lq.counter.swipelayout.mylinearswipelayout android:id="@+id/sample1" android:layout_width="match_parent" android:layout_height="120dp" android:orientation="horizontal"> <linearlayout android:id="@+id/bottom_layout" android:background="@mipmap/sceen" android:orientation="horizontal" android:visibility="visible" android:layout_width="match_parent" android:layout_height="match_parent"> </linearlayout> <linearlayout android:id="@+id/bottom_wrapper" android:background="#66ddff00" android:layout_width="160dp" android:orientation="horizontal" android:layout_height="match_parent"> <textview android:id="@+id/tv1" android:layout_width="80dp" android:layout_height="match_parent" android:text="删除" android:background="@mipmap/wind" /> <textview android:layout_width="80dp" android:layout_height="match_parent" android:text="收藏" android:background="@mipmap/kaer" /> </linearlayout> </com.lq.counter.swipelayout.mylinearswipelayout>
父布局里面有两个子linearlayout,第一个我们称为surface,它宽度为match_parent,是可见的布局,第二个我们称为bottom,它在屏幕之外,是隐藏的布局(这里是最基本的概念)。
1.首先在我们swipelayout的构造方法中初始化viewdraghelper:helper = viewdraghelper.create(this,callback);
2.准备好5个待会要用的方法:
@override public boolean onintercepttouchevent(motionevent ev) { return helper.shouldintercepttouchevent(ev); } @override public boolean ontouchevent(motionevent event) { helper.processtouchevent(event); return true; } private view getsurfaceview(){ return getchildat(0); } private view getbottomview(){ return getchildat(1); } private enum state{ close, open }
这里可以看到将控件的拦截和处理全都放权给了viewdraghelper,当然了,当你遇到子view点击事件莫名其妙的失效或者产生时,你就要在拦截处理里面找突破口,不过今天我们不涉及子view的点击事件处理,只是为了完成滑动展示两个隐藏子view就行。
3.开始重写callback
private viewdraghelper.callback callback = new viewdraghelper.callback() { private state state; @override public boolean trycaptureview(@nonnull view child, int pointerid) { if (getsurfaceview().getleft() == 0){ state = state.close; }else { state = state.open; } return true; } };
注意:getsurfaceview.getleft==0,这么写是基于父布局paddingleft = 0来写的,不过不要紧,这里在捕获子view时,先记录了bottomlayout 是展示还是隐藏的,待会会用到这个状态。
接着给两个子view水平滑动设置边界:
@override public int clampviewpositionhorizontal(@nonnull view child, int left, int dx) { if (child == getsurfaceview()) { if (left > 0) { left = 0; } if (left < -getbottomview().getmeasuredwidth()) { left = -getbottomview().getmeasuredwidth(); } } else { int marleft = getsurfaceview().getmeasuredwidth() - getbottomview().getmeasuredwidth(); if (left < marleft){ left = marleft; } } return left; }
surface有两处边界,bittomlayout只有一处边界,理解他们各自的临界状态,可以通过画些草图,看bottomlayout完全展示和完全隐藏这两种极端情况。
在回过头看看上方的dragto()方法,你会发现在调用了clampviewpositionhorizontal 之后,子view就会移动到新设置好的位置,但有个问题,既然我拖动的子view移动了,另一个子view却依旧在原地,怎么办,这时
onviewpositionchanged()就可以解决这个问题,我们让另一个view也跟着移动。
@override public void onviewpositionchanged(@nonnull view changedview, int left, int top, int dx, int dy) { if (changedview == getsurfaceview()){ getbottomview().offsetleftandright(dx); }else { getsurfaceview().offsetleftandright(dx); } invalidate(); }
为什么使用dx,我把dragto的代码再给大家看一次,并标注了一下,就更清楚了,一个子view移动多少距离,另一个子view也紧跟着在相同方向移动相同的距离,这样整体看起来父布局就整个在滑动:
如果你写到这里,其实我们的view已经可以滑起来,但你会感觉手感欠佳,比如bottomlayout会展示一部分,一部分还在屏幕外,我想快速滑动一小段距离就把整个bottomlayout给展示出来,而不是滑动一整个 隐藏view的宽度才能看到它。对对对!这些都是缺点,接下来,今天介绍的最后一个回调onviewrelased 将解决这些问题。
@override public void onviewreleased(@nonnull view releasedchild, float xvel, float yvel) { float minv = helper.getminvelocity()*5; float fraction = state == state.close ? 0.25f:0.75f; if (math.abs(xvel) > minv){ if (state == state.close){ if (xvel > 0 ){ close(); }else { open(); } }else { if (xvel >0){ close(); }else { open(); } } }else { //匀速 if(math.abs(getsurfaceview().getleft()) > getbottomview().getmeasuredwidth()*fraction){ open(); }else { close(); } } invalidate(); }
1.这里有最小速度阈值,默认是100px/s,我乘以5是为了降低速度的敏感度。当大于最小速度,我们可以认为用户快速地滑动了一下,那么根据当前状态,可以分两组情况: 现在是关闭,如果用户快速右滑,xvel>0,那么就是关闭,如果左滑呢,那么就是打开。 现在是关闭,推理同上。 2.小于最小速度,那么就是匀速滑动,或慢慢滑动,这时不再以速度作为参考标准,而以surfacelayout滑动的距离与bottomlayout的占比fraction的大小比较作为用户意图的评判标准。分两种情况: 现在是关闭,此时fraction = 0.25,我们判断如果surface的x坐标超过了bottomlayout宽度的四分之一,那么就是打开,当然,我们此时使用的surface的x的绝对值,而这个值其实是不会大于0的, 因为在水平移动时,mleft已经做了边界处理。 现在是打开,此时fraction = 0.75;这时surface隐藏在屏幕左边的区域大小恰好就是bottomlayout整个的宽度,当用户左滑时,getsuefaceview的横坐标绝对值没有改变,还是bottomlayout的 宽度,所以还是打开,当用户右滑时,surface的mleft在bottomlayout的宽度比例1.0至0.75区间内,都可以认为维持现状,即open,一旦到了[0.75,0]区间,那么就认为是关闭。 接下来看open与close的实现:
private void close(){ helper.smoothslideviewto(getsurfaceview(), 0, 0); } private void open(){ helper.smoothslideviewto(getsurfaceview(),-getbottomview().getmeasuredwidth(),0); }
这两个方法都调用了smoothslideviewto,它的作用就是将你的view平滑地滚动到指定的位置。到了这里,不知道你是否留意到,我滚动的view都是surfacelayout,为什么bottomlayout不去也调这个方法, 难道还让它待在原地吗,其实,我在open和close后面都加了一行invalidate,它让我们的父布局重新layout一次,你把surfacelayout移到坐标原点处,那么按照linearlayout的布局特征,它会把另一个 子view的布局参数也挪到surfacelayout后头。而且,这个方法它本身只是设置好了view的终点位置,真正触发滚动,还得用invalidate。它的实现跟scroller是类似的,在第一次重绘时,调用computescroll, 在computescroll里面判断是否已经移到终点,没有的话接着invalidate,invalidate里面又会去重绘。。。这样一直持续下去,直至,computescroll里面认定view已经到达终点,就不再调invalidate。
@override public void computescroll() { if (helper.continuesettling(true)){ viewcompat.postinvalidateonanimation(this); } }
这里我们用continuesetting来判断动画是否应该继续,为什么用它呢,api文档里提示了: 前面说过每次重绘都会调用computescroll,而这个方法是空实现,所以我们就在它里面判断是否要继续执行动画,返回值为ture就是继续执行动画,当然了,continuesetting()这个方法为什么传true, 因为这个方法前头有一段感人肺腑的话:set this to true if you are calling this method from{@link android.view.view#computescroll()},让我节约了不少脑细胞。还有一点,如果继续执行动画,
viewcompat.postinvalidateonanimation(this)换成invalidate也可以。最后是完整代码,真的没有150行!!!
public class swipelayout extends linearlayout { private viewdraghelper helper; public swipelayout(context context) { this(context,null); } public swipelayout(context context, @nullable attributeset attrs) { this(context, attrs,0); } public swipelayout(context context, @nullable attributeset attrs, int defstyleattr) { super(context, attrs, defstyleattr); helper = viewdraghelper.create(this,callback); } private viewdraghelper.callback callback = new viewdraghelper.callback() { private state state; @override public boolean trycaptureview(@nonnull view child, int pointerid) { if (getsurfaceview().getleft() == 0){ state = state.close; }else { state = state.open; } return true; } @override public int clampviewpositionhorizontal(@nonnull view child, int left, int dx) { if (child == getsurfaceview()) { if (left > 0) { left = 0; } if (left < -getbottomview().getmeasuredwidth()) { left = -getbottomview().getmeasuredwidth(); } } else { int marleft = getsurfaceview().getmeasuredwidth() - getbottomview().getmeasuredwidth(); if (left < marleft){ left = marleft; } } return left; } @override public void onviewpositionchanged(@nonnull view changedview, int left, int top, int dx, int dy) { if (changedview == getsurfaceview()){ getbottomview().offsetleftandright(dx); }else { getsurfaceview().offsetleftandright(dx); } invalidate(); } @override public void onviewreleased(@nonnull view releasedchild, float xvel, float yvel) { float minv = helper.getminvelocity()*5; float fraction = state == state.close ? 0.25f:0.75f; if (math.abs(xvel) > minv){ if (state == state.close){ if (xvel > 0 ){ close(); }else { open(); } }else { if (xvel >0){ close(); }else { open(); } } }else { //匀速 if(math.abs(getsurfaceview().getleft()) > getbottomview().getmeasuredwidth()*fraction){ open(); }else { close(); } } invalidate(); } }; private void close(){ helper.smoothslideviewto(getsurfaceview(), 0, 0); } private void open(){ helper.smoothslideviewto(getsurfaceview(),-getbottomview().getmeasuredwidth(),0); } @override public void computescroll() { if (helper.continuesettling(true)){ viewcompat.postinvalidateonanimation(this); } } @override public boolean onintercepttouchevent(motionevent ev) { return helper.shouldintercepttouchevent(ev); } @override public boolean ontouchevent(motionevent event) { helper.processtouchevent(event); return true; } private view getsurfaceview(){ return getchildat(0); } private view getbottomview(){ return getchildat(1); } private enum state{ close, open } }
至此,这个控件滑一滑是没问题的,但点一点是没什么反应的,下一篇,我们给这个控件加上点击事件,还是基于这个类。相信,基于这个简单控件的使用,dragviewhelper的基本使用是没太大问题的。 转自:https://www.cnblogs.com/shu94/p/12757399.html
下一篇: 如何选择好的变量名!