向左拖拽跳转至“更多页面”的通用控件

2016-12-03 00:43:50 +08:00
 uin3566

Github

https://github.com/uin3566/DragFooterView

效果图

项目来源

本项目来源于公司的项目需求,需要做成如下效果:

这是某个 App 里面的效果,名字我就不说啦,不打免费广告,哈。 我发现市面上很多 app 都有这方面的需求,但基本上都是在右上角添加一个“更多”标签,然后点击“更多”跳转至另一个页面,类似于下面这样,此图来自豆瓣 App 。

这种体验中规中矩,但我还是觉得向左拖拽比较。。于是就写下了本项目,为这种向左拖拽的交互方式提供一种通用的解决方案

介绍

作为一种 library ,怎么可以只有以上这一种效果呢。因此,可插拔的 Footer View是必须的。 下面是我定制的另外两种效果,当然,你也可以定制任意你想要的效果。

上图中的字符串转 Path功能用的是秋百万大神的android-Ultra-Pull-To-Refresh下拉刷新库中的类StoreHousePath,只不过将字符串从横向改为了竖向,在此深表感谢,顺便膜拜下。

涉及的知识点

本质上说,这个控件是一个自定义的 ViewGroup,需要支持左滑,需要支持可插拔化的 Footer View ,所以View 的事件分发, View 的绘制这两个知识点都必须用到。 View 的绘制就不多说了,无非是 Canvas , Paint , Path 结合动画的用法,**GcsSloop 魔法师的文章讲解的又好逼格又高,推荐下,具体的绘制可以看我的代码,自以为写的还是蛮清晰的 e 。 这里看下事件分发,由于 DragContainer 支持放置了各种子 View ,比如 Button , RecyclerView , HorizontalScrollView 等。那么,有时候需要子控件响应事件,有时候需要 DragContainer 响应拖拽**。本项目通过重写 dispatchTouchEvent 实现需求,代码分析详见代码中的注释。

    @Override
    public boolean dispatchTouchEvent(MotionEvent event) {
        //若复位动画正在执行,则直接 return
        if (resetAnimator != null && resetAnimator.isRunning()) {
            return super.dispatchTouchEvent(event);
        }

        //调用 ViewGroup 的 dispatchTouchEvent 方法,将
        //事件分发给子 View 。
        super.dispatchTouchEvent(event);

        //调用 IDragChecker 接口的 canDrag 方法判断此时 DragContainer 
        //的可拖拽状态,本项目提供了默认实现类 DefaultDragChecker 
        //将根据子 View 的类型来返回一个 boolean 。若返回 false ,
        //则该方法直接返回,返回 true 才能执行后续的拖拽操作。
        //以 RecyclerView 为例,若 RecyclerView 没有滑动到最底部
        //则返回 false ,否则返回 true , DragContainer 将会对后续事件
        //进行处理。
        if (!dragChecker.canDrag(contentView)) {
            return true;
        }

        //DragContainer 处理拖拽事件
        switch (event.getAction()) {
            case MotionEvent.ACTION_DOWN:
                dragDx = 0;
                downX = event.getX();
                downY = event.getY();
                lastMoveX = downX;
                break;
            case MotionEvent.ACTION_MOVE:
                float dx = Math.abs(event.getX() - downX);
                float dy = Math.abs(event.getY() - downY);
                //dx >= dy 时判定为横向拖动,不允许 parentViewGroup
                //拦截事件,否则使之拦截事件。
                if (dx >= dy) {
                    getParent().requestDisallowInterceptTouchEvent(true);
                } else {
                    getParent().requestDisallowInterceptTouchEvent(false);
                }

                //若此时往左拖动,则开始处理 ACTION_MOVE 事件
                if (dragDx <= 0 && dragChecker.canDrag(contentView)) {
                    //这里更新拖拽状态, Footer View 的绘制依赖于该状态
                    //该函数判断此时是往左拖拽还是往右拖拽。
                    updateDragState(event);
                    if (dragDx != 0) {
                        //拖拽时发送 ACTION_CANCEL 给子 View ,取消 View 的事件序列,否则 View 将与 DragContainer 产生事件冲突。
                        sendCancelEvent(event);
                    }
                    dragDx = event.getX() - downX;
                    //dragDamp 是拖拽阻尼,取值范围是(0,1]。值越小,阻尼越大
                    float realDragDistance = dragDx * dragDamp;
                    //更新子 View 的位置。
                    setContentView((int) realDragDistance, 0, containerWidth + (int) realDragDistance, containerHeight);
                }
                break;
            case MotionEvent.ACTION_CANCEL:
            case MotionEvent.ACTION_UP:
                //手指抬起时或接收到 ACTION_CANCEL 时子 View 恢复原位。
                resetContentView();
                break;
        }
        return true;
    }

用法

1 、添加依赖

    allprojects {
        repositories {
            ...
	        maven { url "https://jitpack.io" }
        }
    }
    dependencies {
        compile 'com.github.uin3566:DragFooterView:v1.0.2'
    }

2 、在 xml 中配置如下 (注意: DragContainer 只能有一个子 View)

    <com.fangxu.library.DragContainer
        android:id="@+id/drag_recycler_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginLeft="10dp">

        <android.support.v7.widget.RecyclerView
            android:id="@+id/recycler_view"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:background="@android:color/white" />
    </com.fangxu.library.DragContainer>

3 、在 java 类中添加事件监听器 DragListener

    DragContainer dragContainer = (DragContainer) findViewById(R.id.drag_image_view);
    
    //若需使用自己定制的 footer ,需要调用 DragContainer 的 setFooterDrawer 方法设置定制的 footer 类,如下
    //其中 ArrowPathFooterDrawer 继承于 BaseFooterDrawer
    dragContainer.setFooterDrawer(new ArrowPathFooterDrawer.Builder(this, 0xff444444).setPathColor(0xffffffff).build());
    
    dragContainer.setDragListener(new DragListener() {
        @Override
        public void onDragEvent() {
            //do whatever you want,for example skip to the load more Activity.
            Intent intent = new Intent(HomeActivity.this, ShowMoreActivity.class);
            startActivity(intent);
        }
    });

可自定义属性

|attribute|value type|defalut value| description| | --- | --- | --- | --- | |dc_footer_color|color|0xffcdcdcd|footer view 的背景颜色| |dc_reset_animator_duration|integer|700|松开拖拽后复位动画的时长| |dc_drag_damp|float|0.5f|拖拽阻尼系数,取值在(0,1]之间,取值越小,阻尼越大|
其余 footer view 的属性参数交给 BaseFooterDrawer 的实现类自己设置。

小结

木有小结,我就是来打广告的,哈哈,如果你觉得本项目对你的学习有帮助,具有一定的实用价值,那就多多 star ,多多 follow 吧! 最后再厚颜无耻地再贴一次 github 地址: https://github.com/uin3566/DragFooterView

1977 次点击
所在节点    分享创造
0 条回复

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/324959

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX