仿探探卡片滑动的实现原理:CardSwipeLayout之onChildDraw实时旋转与卡片前进动画逐行拆解
仿探探卡片滑动的实现原理: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);
对比初始布局的公式,两个关键增量:
- scale 加上
|ratio| × 0.1:主卡滑得越远,后方卡片缩放越大——它正在"长大"; - 位移项变成
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,动作分三步:
- 摘除触摸监听:
setOnTouchListener(null),避免旧监听干扰后续卡片的手势; - 数据源移除:
dataList.remove(layoutPosition)+adapter.notifyDataSetChanged(),RecyclerView 自动重新布局,后方卡片按第二节的公式自然"就位"; - 回调业务:告知滑出方向;若
getItemCount() == 0则追加调用onSwipedClear(),业务层可在此加载更多数据(示例中 3 秒后重新填充)。
五、快速上手清单
把这套仿探探卡片滑动接入自己的项目,只需四步(完整代码见 MainActivity):
- 初始化 RecyclerView 并设置 Adapter;
new CardItemTouchHelperCallback(adapter, dataList)创建回调;new CardLayoutManager(recyclerView, touchHelper)设为布局管理器;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,也能自己动手写出一个属于自己的卡片滑动布局。