Android侧滑原来能够这么优雅

时间 2019-11-08

原文原文链接

前言

侧滑手势在Android App应用得很是普遍，常见的使用场景包括：滑动抽屉、侧滑删除、侧滑返回、下拉刷新以及侧滑封面等。因为这些使用场景实在是太通用了，各路大神们八仙过海各显神通，每种侧滑场景都开源出了不少很是实用的框架，让咱们的业务开发便利了不少。html

目前，咱们须要为每种场景引入不一样的侧滑框架，因为App中的侧滑场景不少，咱们项目中也就须要引入多个侧滑框架，而每一个框架的使用方式各有不一样，须要单独学习，团队的学习成本较高。java

那么问题来了，有没有一种框架能解决全部侧滑需求呢？android

一个框架解决全部侧滑需求？你肯定不是在开玩笑？

在刚开始学习面向对象编程概念的时候咱们就知道一个道理：解决一个软件问题，首先要将它抽象出来。git

针对侧滑这个手势，咱们能不能将它的概念抽象一下，到底侧滑指的是什么呢？github

狭义侧滑：从屏幕的某侧的边缘开始向着远离该边缘的方向滑动
广义侧滑：手指在屏幕上按下以后向着某一侧方向滑动

个人理解是，广义侧滑包含狭义侧滑，只不过是触发区域是否在屏幕边缘的区别罢了。web

因而，侧滑的概念就这样被清晰地抽象出来了。编程

从这个抽象概念能够看出：侧滑手势同一时间只处理上下左右4个方向中的一个方向

若是咱们将这个抽象概念封装出来，将手势事件的识别、拦截及数据加工在框架内部处理好，并向外实时地输出侧滑方向、距离及相关的回调，理论上咱们就能够实现全部的侧滑需求了。微信

至于具体的侧滑效果，学过策略模式的都知道：
每一种具体的侧滑效果实现均可以看作是一种侧滑策略。

说的那么玄乎，到底咋弄？

胸抬，憋急！磨刀不误砍柴工，站在巨人的肩膀上你就有可能比巨人高那么一点点。app

Google在android support库中为侧滑菜单的需求提供了SlidingPaneLayout和DrawerLayout两种实现，看源码会发现二者都是基于ViewDragHelper来实现的，那么ViewDragHelper又是何方神圣呢？框架

ViewDragHelper是android support库中的一个工具类。它能够帮助咱们处理控件的拖拽，它的使用方式为：先建立一个自定义ViewGroup，将被拖动的控件添加到这个自定义ViewGroup中，并用ViewDragHelper来处理控件的拖拽，能够经过Callback来指定拖拽区域及捕获子控件的逻辑。

经过阅读ViewDragHelper的源码发现，它对view在父容器中的拖拽行为进行了封装，经过拦截父容器控件的手势事件，捕获须要拖拽的子控件，并实时根据手指的移动改变它的坐标，从而实现拖拽效果。

ViewDragHelper封装的很优雅，也很强大，
有些开源侧滑框架也是基于ViewDragHelper来实现的,例如：
ikew0ng/SwipeBackLayout / daimajia/AndroidSwipeLayout

不过，ViewDragHelper封装的是子控件的拖拽，而不是侧滑，它计算距离的基准是控件的top和left坐标，虽然能够将其中一个方向（横向或纵向）的拖动范围设置为0来模拟侧滑手势，但它不符合咱们侧滑手势的抽象定义，没法解决侧滑时不是控件移动的效果。

例如：MIUI系统侧滑返回效果及小米公司出品的App广泛使用的弹性拉伸效果等

别扯那些没用的，赶忙讲侧滑

既然侧滑已经被清晰地抽象出来了，一样是对触摸滑动事件的处理，咱们彻底能够借鉴ViewDragHelper的思想：将它对子控件的捕获和拖动，改为对侧滑方向的捕获和侧滑距离的计算，并将它的Callback改形成侧滑距离的消费者(具体的侧滑效果就看消费者用哪一种方式来消费掉这个侧滑距离)。

侧滑行为的2个核心要素：
侧滑方向、侧滑距离

根据这个思路，我封装了一个智能的侧滑框架：SmartSwipe，能够解决你所(chui)有(niu)的(bi)侧滑需求。请大声说出它的slogan！

关于侧滑，有这一个就够了

固然，这是吹牛逼的！

框架只是封装了侧滑行为事件的捕获、分发及多点交替滑动的处理，具体的侧滑效果（消费侧滑距离的策略）须要你本身来实现。。。哎。。。等等，胸抬，先别走啊！还没说完呢，SmartSwipe中内置了十多种常见侧滑效果，有动图为证：

1. 一行代码让页面动起来

//仿iOS的弹性留白效果：
//侧滑时表现为弹性留白效果，结束后自动恢复
SmartSwipe.wrap(view)
    .addConsumer(new SpaceConsumer())
    .enableVertical(); //工做方向：纵向

2. 一行代码让页面具备弹性

//仿MIUI的弹性拉伸效果：
//侧滑时表现为弹性拉伸效果，结束后自动恢复
SmartSwipe.wrap(view)
    .addConsumer(new StretchConsumer())
    .enableVertical(); //工做方向：纵向

3. 一行代码添加滑动抽屉

抽屉显示在主view之上，相似于DrawerLayout

SmartSwipe.wrap(view)
    .addConsumer(new DrawerConsumer())    //抽屉效果
    //能够设置横向(左右两侧)的抽屉为同一个view
    //也能够为不一样方向分别设置不一样的view
    .setHorizontalDrawerView(menuLayout) 
    .setScrimColor(0x2F000000) //设置遮罩的颜色
    .setShadowColor(0x80000000)    //设置边缘的阴影颜色
    ;

4. 一行代码添加带联动效果的滑动抽屉

抽屉显示在主view之下

SmartSwipe.wrap(view)
    .addConsumer(new SlidingConsumer())
    .setHorizontalDrawerView(textView)
    .setScrimColor(0x2F000000)
    //设置联动系数
    //  0:不联动，视觉效果为：主体移动后显示下方的抽屉
    //  0~1: 半联动，视觉效果为：抽屉视图按照联动系数与主体之间存在相对移动效果
    //  1:全联动，视觉效果为：抽屉跟随主体一块儿移动(pixel by pixel)
    .setRelativeMoveFactor(0.5F) 
    ;

5. 一行代码添加滑动透明效果

侧滑透明效果，侧滑后可显示被其遮挡的view，可用做侧滑删除，也能够用来制做封面效果

//侧滑删除
SmartSwipe.wrap(view)
    .addConsumer(new TranslucentSlidingConsumer())
    .enableHorizontal() //启用左右两侧侧滑
    .addListener(new SimpleSwipeListener(){
        @Override
        public void onSwipeOpened(SmartSwipeWrapper wrapper, SwipeConsumer consumer, int direction) {
            //侧滑打开时，移除
            ViewParent parent = wrapper.getParent();
            if (parent instanceof ViewGroup) {
                ((ViewGroup) parent).removeView(wrapper);
            }
            //adapter.removeItem(getAdapterPosition());// 也可用做从recyclerView中移除该项
        }
    })
    ;

6. 一行代码添加侧滑手势识别功能

侧滑时，主view保持不动，手指释放时，识别滑动方向及速率，以肯定是否执行对应的侧滑逻辑。

//demo：用StayConsumer来作activity侧滑返回
SmartSwipe.wrap(this)
    .addConsumer(new StayConsumer())
    .enableAllDirections()
    .addListener(new SimpleSwipeListener(){
        @Override
        public void onSwipeOpened(SmartSwipeWrapper wrapper, SwipeConsumer consumer, int direction) {
            finish();
        }
    })
    ;

7. 一行代码添加百叶窗效果

侧滑时主view像百叶窗同样打开，透明显示下层的视图。

可用来制做封面、轮播图等

//用ShuttersConsumer实现百叶窗侧滑删除
SmartSwipe.wrap(view)
    .addConsumer(new ShuttersConsumer())
    .enableHorizontal() //启用左右两侧侧滑
    .addListener(new SimpleSwipeListener(){
        @Override
        public void onSwipeOpened(SmartSwipeWrapper wrapper, SwipeConsumer consumer, int direction) {
            //侧滑打开时，移除
            ViewParent parent = wrapper.getParent();
            if (parent instanceof ViewGroup) {
                ((ViewGroup) parent).removeView(wrapper);
            }
            //adapter.removeItem(getAdapterPosition());// 也可用做从recyclerView中移除该项
        }
    })
    ;

8. 一行代码添加开门效果

侧滑时，主view像开门同样从中间向两边(上下或左右)分开，透明显示它下层的视图

可用来制做封面、轮播图等

//用DoorConsumer实现百叶窗侧滑删除
SmartSwipe.wrap(view)
    .addConsumer(new DoorConsumer())
    .enableHorizontal() //启用左右两侧侧滑
    .addListener(new SimpleSwipeListener(){
        @Override
        public void onSwipeOpened(SmartSwipeWrapper wrapper, SwipeConsumer consumer, int direction) {
            //侧滑打开时，移除
            ViewParent parent = wrapper.getParent();
            if (parent instanceof ViewGroup) {
                ((ViewGroup) parent).removeView(wrapper);
            }
            //adapter.removeItem(getAdapterPosition());// 也可用做从recyclerView中移除该项
        }
    })
    ;

9. 一行代码添加贝塞尔曲线返回效果

侧滑时，在控件侧滑的边缘显示一个贝塞尔曲线的返回效果

可用于activity返回、fragment返回，也可用于webview的返回/前进

//activity侧滑返回
SmartSwipe.wrap(this)
    .addConsumer(new BezierBackConsumer())
    .enableAllDirections()
    .addListener(new SimpleSwipeListener() {
        @Override
        public void onSwipeOpened(SmartSwipeWrapper wrapper, SwipeConsumer consumer, int direction) {
            finish();
        }
    })
    ;

10. 一行代码添加仿微信Activity联动侧滑返回效果

没错，专为activity侧滑返回而做的一种效果，带联动功能

//activity侧滑返回
SmartSwipe.wrap(this)
    .addConsumer(new ActivitySlidingBackConsumer(this))
    //设置联动系数
    .setRelativeMoveFactor(0.5F)
    //指定可侧滑返回的方向，如：enableLeft() 仅左侧可侧滑返回
    .enableAllDirections() 
    ;

11. 一行代码添加Activity百叶窗侧滑返回效果

没错，也是专为activity侧滑返回而做的一种效果，透明显示前一个activity

//activity侧滑返回
SmartSwipe.wrap(this)
    .addConsumer(new ActivityShuttersBackConsumer(this))
    .setScrimColor(0x7F000000)
    .enableAllDirections()
    ;

12. 一行代码添加Activity开门侧滑返回效果

没错，这仍是一个专为activity侧滑返回而做的效果，透明显示前一个activity

//activity侧滑返回
SmartSwipe.wrap(this)
    .addConsumer(new ActivitySlidingBackConsumer(this))
    .setRelativeMoveFactor(0.5F)
    .enableAllDirections()
    ;

怎么都是一行代码？还敢不敢再来点？

SmartSwipe中绝大多数的使用均可以经过链式编程在一行代码内完成，API的设计风格以下：

SmartSwipe.wrap(...)         //view or Activity
    .addConsumer(...)         //添加consumer
    .enableDirection(...)     //指定consumer接收哪一个方向的侧滑事件
    .setXxx(...)             //[可选]一些其它设置项
    .addListener(...);         //[可选]给consumer添加监听

除了基础的侧滑效果外，为了方便开发者使用，还封装了工具类：SmartSwipeBack 和 SmartSwipeRefresh

一行代码实现全局Activity侧滑返回

全局只需一行代码便可搞定全部Activity侧滑返回
可选样式：开门、百叶窗、仿微信、仿QQ及仿MIUI贝塞尔曲线
无需透明主题
无需继承某个特定的Activity
不须要侵入xml布局文件
也不须要侵入BaseActivity
支持全屏侧滑和(/或)边缘侧滑返回
支持上/下/左/右 4个方向侧滑返回

//仿手机QQ的手势滑动返回
SmartSwipeBack.activityStayBack(application, null);        
//仿微信带联动效果的透明侧滑返回
SmartSwipeBack.activitySlidingBack(application, null);    
//侧滑开门样式关闭activity
SmartSwipeBack.activityDoorBack(application, null);        
//侧滑百叶窗样式关闭activity
SmartSwipeBack.activityShuttersBack(application, null);    
//仿小米MIUI系统的贝塞尔曲线返回效果
SmartSwipeBack.activityBezierBack(application, null);

一行代码添加下拉刷新功能

可用于任意view

//xxxMode第二个参数为false，表示工做方向为纵向：下拉刷新&上拉加载更多
//若是第二个参数设置为true，则表示工做方向为横向：右拉刷新&左拉加载更多
SmartSwipeRefresh.drawerMode(view, false).setDataLoader(loader);
SmartSwipeRefresh.behindMode(view, false).setDataLoader(loader);
SmartSwipeRefresh.scaleMode(view, false).setDataLoader(loader);
SmartSwipeRefresh.translateMode(view, false).setDataLoader(loader);

样式	效果图
drawerMode
behindMode
scaleMode
translateMode

header和footer可以使用第三方炫酷的自定义view，如：基于Ifxcyr/ArrowDrawable的ArrowHeader，效果图以下：

看起来是蛮diao的，但是我要的侧滑效果你这里没有啊

这就须要自定义SwipeConsumer了，步骤以下：

新建一个类，继承SwipeConsumer
[可选]在构造方法中进行一些初始化（须要context对象才能初始化的属性，能够放在onAttachToWrapper方法中初始化）
[可选]若是有额外的捕获逻辑，能够重写父类的tryAcceptMoving和tryAcceptSettling方法
[可选]重写onSwipeAccepted方法，因为此时已经肯定捕获了侧滑事件，并肯定好了侧滑的方向(mDirection)，能够为本次侧滑事件作一些初始化工做
[可选]重写clampDistanceHorizontal及clampDistanceHorizontal方法，可在知足必定条件下才真正执行侧滑
重写onDisplayDistanceChanged方法，执行具体的侧滑的UI效果呈现
[可选]若是UI呈现效果中包含布局控件的移动，须要重写onLayout方法，在此方法中也要按照侧滑后的逻辑进行控件布局定位
重写onDetachFromWrapper方法，还原现场，移除当前consumer的全部改动痕迹

以框架内置弹性拉伸效果StretchConsumer为例

根据侧滑距离，对contentView进行缩放和平移，从而实现弹性拉伸效果

代码以下：

public class StretchConsumer extends SwipeConsumer {
    @Override
    public void onDetachFromWrapper() {
        super.onDetachFromWrapper();
        View contentView = mWrapper.getContentView();
        if (contentView != null) {
            contentView.setScaleX(1);
            contentView.setScaleY(1);
            contentView.setTranslationX(0);
            contentView.setTranslationY(0);
        }
    }

    @Override
    public void onDisplayDistanceChanged(int distanceXToDisplay, int distanceYToDisplay, int dx, int dy) {
        View contentView = mWrapper.getContentView();
        if (contentView != null) {
            if (distanceXToDisplay >= 0 && isLeftEnable() || distanceXToDisplay <= 0 && isRightEnable()) {
                contentView.setScaleX(1 + Math.abs((float) distanceXToDisplay) / mWidth);
                contentView.setTranslationX(distanceXToDisplay / 2F);
            }
            if (distanceYToDisplay >= 0 && isTopEnable() || distanceYToDisplay <= 0 && isBottomEnable()) {
                contentView.setScaleY(1 + Math.abs((float) distanceYToDisplay) / mHeight);
                contentView.setTranslationY(distanceYToDisplay / 2F);
            }
        }
    }
}

以上就是实现弹性拉伸效果的所有代码，很简单，不是吗？

这样看来，也许还真能实现全部侧滑效果诶？

能实现全部侧滑效果只存在于理论上，确定还须要不断地完善，开源出来也是但愿能利用开源社区的力量来完善它，让android侧滑更简单！

文档： https://luckybilly.github.io/SmartSwipe-tutorial/ (采用gitbook形式精心编写而成)

Demo下载: https://github.com/luckybilly/SmartSwipe/raw/master/app-release.apk

本文做者：luckybilly

阅读原文

本文为云栖社区原创内容，未经容许不得转载。