zhuchen1109 / Swipe-cards

类似探探和tinder,可以左右滑动的层叠卡片

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

有图有真相:

视频地址

如何使用(直接看demo工程,清晰易懂):

DEMO体验下载

Step1: 配置build.gradle

allprojects {
    repositories {
        jcenter()
        maven { url 'https://jitpack.io' }
    }
}
dependencies {
	compile 'com.github.zhuchen1109:Swipe-cards:18df0b545b'
}

Step2: 在你的布局文件中加入

<com.zc.swiple.SwipeFlingView
        android:id="@+id/layout_swipe_fling"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:max_visible=“4”
        app:min_adapter_stack="3"
        app:rotation_degrees="15"/>

Step3: 主要代码(参考DEMO工程):

mAdapter = new UserAdapter(getActivity(), mList);
mSwipeFlingView.setAdapter(mAdapter);
mSwipeFlingView.setOnSwipeFlingListener(this);
mSwipeFlingView.setOnItemClickListener(this);

属性描述:

app:max_visible        最大同时显示几张卡片
app:min_adapter_stack  卡片剩余多少张时,开始加载下一页
app:rotation_degrees   卡片拖拽中,最大的旋转角度

请允许我来给这个项目吹吹牛

  • 1.易用 和使用listview一样方便,提供Adapter来定制视图

  • 2.视图复用 无论划多少页,全局只有4个卡片view

  • 3.流畅 再快的手势也永远感觉不到卡的刹那

  • 4.高效 使用硬件加速方式更新拖拽视图,拖拽操作不使用invalidate(invalidate会重新生成FBO,使渲染效率降低)

  • 5.精细 卡片与卡片之间动画联动效果是像素级的

API说明:

这个项目在实际产品中经历过各种需求的洗礼,有着多轮的迭代优化,现在API已较为完善

核心回调如下:

public interface onSwipeListener {

        //void onStart(SwipeFlingViewNew swipeFlingView);

        /**
         * 拖拽开始时调用
         */
        void onStartDragCard();

        /**
         * 用来判断是否允许卡片向左离开(fling)
         *
         * @return true:允许卡片向左离开(fling)
         */
        boolean canLeftCardExit();

        /**
         * 用来判断是否允许卡片向右离开(fling)
         *
         * @return true:允许卡片向右离开(fling)
         */
        boolean canRightCardExit();

        /**
         * 在卡片即将要离开(fling)前,会回调此函数
         */
        void onPreCardExit();

        /**
         * 在卡片向左完全离开时,会回调此函数
         *
         * @param view               当前的view
         * @param dataObject
         * @param triggerByTouchMove 若true:表示此次卡片离开是来之于手势拖拽 反之则来之于点击按钮触发之类的
         */
        void onLeftCardExit(View view, Object dataObject, boolean triggerByTouchMove);

        /**
         * 在卡片向右完全离开时,会回调此函数
         *
         * @param view               当前的view
         * @param dataObject
         * @param triggerByTouchMove 若true:表示此次卡片离开是来之于手势拖拽 反之则来之于点击按钮触发之类的
         */
        void onRightCardExit(View view, Object dataObject, boolean triggerByTouchMove);

        /**
         * 在卡片完全离开时,若来之于superlike,会回调此函数
         *
         * @param view               当前的view
         * @param dataObject
         * @param triggerByTouchMove 若true:表示此次卡片离开是来之于手势拖拽 反之则来之于点击按钮触发之类的
         */
        void onSuperLike(View view, Object dataObject, boolean triggerByTouchMove);

        /**
         * 在顶部卡片划走时,会刷新布局,将设置顶部下面的卡片为顶部卡片,此时会回调此函数
         */
        void onTopCardViewFinish();

        /**
         * 当剩余卡片数等于{@link SwipeFlingView#MIN_ADAPTER_STACK}时,会回调此函数
         * 意味着卡片即将划完了,在这个时机可以做预加载下一批数据的工作
         *
         * @param itemsInAdapter
         */
        void onAdapterAboutToEmpty(int itemsInAdapter);

        /**
         * 当所有卡片都划完了,就回调此函数
         */
        void onAdapterEmpty();

        /**
         * 卡片因拖拽或动画发生位移时,会实时回调此函数
         *
         * @param selectedView          发生位移的view
         * @param scrollProgressPercent 范围[-1,1] 默认是0 向左位移是0->-1,向右位移是0->1.
         *                              左侧最大值由{@link #leftBorder()}决定,右侧最大值由{@link #rightBorder()} ()}决定,
         */
        void onScroll(View selectedView, float scrollProgressPercent);

        /**
         * 拖拽结束时调用
         */
        void onEndDragCard();

        //void onEnd();
    }

About

类似探探和tinder,可以左右滑动的层叠卡片


Languages

Language:Java 100.0%