仿探探卡片滑动的实现原理:CardSwipeLayout之onChildDraw实时旋转与卡片前进动画逐行拆解

原创2026-10-12 17:52:531,892 阅读

仿探探卡片滑动的实现原理:CardSwipeLayout之onChildDraw实时旋转与卡片前进动画逐行拆解

CardSwipeLayout 是一个用 RecyclerView 实现探探同款卡片滑动效果的 Android 开源库。本文逐行拆解它的两大核心机制——onChildDraw 实时旋转与卡片前进动画,带你快速看懂仿探探卡片滑动的完整实现原理,适合想给应用添加"左滑右滑"交互的新手与进阶开发者。

仿探探卡片滑动效果的演示卡片

一、效果与核心组件一览

先看一眼成品效果:最上层卡片可左右滑动,滑动时卡片实时倾斜,松手滑出屏幕后,下方卡片"长大"并上移补位——这正是探探的经典交互。

卡片滑动时下方卡片前进的演示图

整个库只有 4 个核心类,分工非常清晰:

类 职责
CardLayoutManager 自定义 RecyclerView 布局,负责"卡片堆叠"的初始排布
CardItemTouchHelperCallback 继承 ItemTouchHelper.Callback,负责滑动跟手、旋转与前进动画
CardConfig 集中管理显示数量、缩放比例、旋转角度等参数
OnSwipeListener 对外暴露 3 个回调,方便业务层做业务处理

理解仿探探卡片滑动,只需要抓住两条线:

  • 布局线:onLayoutChildren 决定卡片"怎么堆";
  • 动画线:onChildDraw 决定卡片"怎么动"。

二、卡片堆叠:onLayoutChildren 如何排布牌堆

在 CardLayoutManager.onLayoutChildren 中,所有卡片先被居中对齐,再按 position 从后往前(牌堆底层→顶层)依次处理:

view.setScaleX(1 - position * CardConfig.DEFAULT_SCALE);
view.setTranslationY(position * view.getMeasuredHeight() / CardConfig.DEFAULT_TRANSLATE_Y);

公式含义很直白:

  • 缩放:1 - position × 0.1,第 1 张 0.9 倍、第 2 张 0.8 倍,越靠后越小,形成"远近透视";
  • 下移:position × 卡片高度 / 14,越靠后的卡片露出的下边缘越多,形成层叠感。

最顶层(position == 0)的卡片不缩放、不位移,并挂上一个 OnTouchListener:手指按下时调用 mItemTouchHelper.startSwipe(),主动"发起"一次 swipe 手势——这一步是后续 onChildDraw 能被驱动的前提。

💡 技巧:只给顶层卡片注册触摸监听,就能保证用户永远只操作"当前这张卡",下方卡片保持静止等待前进。

三、onChildDraw 逐行拆解:实时旋转是怎么来的

仿探探卡片滑动的灵魂就在 CardItemTouchHelperCallback.onChildDraw,每帧滑动事件都会触发它。

3.1 第一步:把位移换算成进度 ratio

float ratio = dX / getThreshold(recyclerView, viewHolder);
if (ratio > 1) ratio = 1;
else if (ratio < -1) ratio = -1;
  • dX 是手指相对起点的水平位移(ItemTouchHelper 传入);
  • getThreshold 返回"滑到多远算完全滑出":recyclerView宽度 × swipeThreshold(默认 0.5,即滑半屏);
  • 用 dX ÷ 阈值 得到归一化进度,并钳制在 [-1, 1],左滑为负、右滑为正。

有了这个 0~1 的"进度条",后面所有动画都能和手指严格同步,这就是"实时"二字的来源。

3.2 第二步:一行代码完成实时旋转

itemView.setRotation(ratio * CardConfig.DEFAULT_ROTATE_DEGREE);

ratio 满格时旋转 15°,中间过程线性插值:手指滑到 30%,卡片就倾斜 4.5°。没有动画补间、没有计算惯性——每帧直接赋值,所以跟手得"指哪打哪"。

注意 clearView 中有一句 setRotation(0f):滑出或回弹结束时把角度归零,防止残留倾斜。

3.3 第三步:卡片前进动画的隐藏技巧

旋转只是表面,真正的精髓在 onChildDraw 后半段的 for 循环:

view.setScaleX(1 - index * DEFAULT_SCALE + Math.abs(ratio) * DEFAULT_SCALE);
view.setTranslationY((index - Math.abs(ratio)) * 卡片高度 / DEFAULT_TRANSLATE_Y);

对比初始布局的公式,两个关键增量:

  1. scale 加上 |ratio| × 0.1:主卡滑得越远,后方卡片缩放越大——它正在"长大";
  2. 位移项变成 index - |ratio|:后方卡片同时上移——它正在"顶上来"。

两项都取 Math.abs(ratio),意味着无论左滑还是右滑,前进动画完全一致,这正是探探手感的来源。

循环里的 position 从牌堆倒数第二张遍历到最底层,index = 总卡片数 - position - 1 换算出每张卡距离顶层的"层距",层距越大基础越小,前进后依然保持层叠顺序。数据不足 3 张时走 else 分支,逻辑相同只是起点位置不同(L106-L115)。

3.4 顺手通知业务层:onSwiping 回调

每帧最后调用 OnSwipeListener.onSwiping,把 viewHolder、ratio、方向常量(SWIPING_LEFT / SWIPING_RIGHT / SWIPING_NONE)交给业务。示例 App 就靠它做"LIKE/DISLIKE 印章随进度淡入":

// 示例:右滑显示 like,左滑显示 dislike(见 MainActivity)
if (direction == CardConfig.SWIPING_RIGHT) {
    myHolder.likeImageView.setAlpha(Math.abs(ratio));
}

完整写法可参考 MainActivity.initView。

四、滑出收尾:onSwiped 里的三步走

当 ratio 到达 ±1,ItemTouchHelper 认为卡片滑出,触发 onSwiped,动作分三步:

  1. 摘除触摸监听:setOnTouchListener(null),避免旧监听干扰后续卡片的手势;
  2. 数据源移除:dataList.remove(layoutPosition) + adapter.notifyDataSetChanged(),RecyclerView 自动重新布局,后方卡片按第二节的公式自然"就位";
  3. 回调业务:告知滑出方向;若 getItemCount() == 0 则追加调用 onSwipedClear(),业务层可在此加载更多数据(示例中 3 秒后重新填充)。

五、快速上手清单

把这套仿探探卡片滑动接入自己的项目,只需四步(完整代码见 MainActivity):

  1. 初始化 RecyclerView 并设置 Adapter;
  2. new CardItemTouchHelperCallback(adapter, dataList) 创建回调;
  3. new CardLayoutManager(recyclerView, touchHelper) 设为布局管理器;
  4. touchHelper.attachToRecyclerView(recyclerView) 并实现 OnSwipeListener。

想调整手感时,只需改 CardConfig 中的 4 个常量:DEFAULT_SHOW_ITEM(堆叠 3 张)、DEFAULT_SCALE(0.1 缩放差)、DEFAULT_TRANSLATE_Y(Y 轴 14 等分)、DEFAULT_ROTATE_DEGREE(最大 15° 倾斜)——参数少而集中,非常利于二次开发。

六、总结:一句话记住原理

  • 堆叠靠 onLayoutChildren:按层距缩放 + 下移;
  • 跟手靠 onChildDraw:dX ÷ 阈值 归一化成 ratio,旋转 = ratio × 15°;
  • 前进靠同一帧里的补偿项:后方卡片 scale 与 translationY 各加一份 |ratio|;
  • 收尾靠 onSwiped:移除数据、重算布局,全部滑完触发 onSwipedClear。

掌握这 4 个环节,你不仅能直接使用 CardSwipeLayout,也能自己动手写出一个属于自己的卡片滑动布局。

登录后查看全文
CardSwipeLayout