丝滑动画的物理学:MFSideMenu如何根据滑动速度精确计算侧边栏动画时长
丝滑动画的物理学:MFSideMenu如何根据滑动速度精确计算侧边栏动画时长
MFSideMenu 是一款经典的开源 iOS 侧边栏菜单(Side Menu)库,用于快速实现 Facebook 风格的左右滑出菜单。它最让人称道的一点,是菜单跟手、松手后动画"丝滑"——秘诀就在于它能根据滑动手指的实时速度,用一条物理公式精确计算动画时长。本文带你拆解这套机制。
为什么侧边栏动画会"丝滑"?
想象你用手推一扇门,松手后门的惯性速度与你松手瞬间的推门速度一致,门才会"顺";如果松手后门突然加速或减速,就会有一种"被电了一下"的割裂感。
MFSideMenu 的做法正是如此:
- 🖐️ 捕捉松手瞬间的速度(点/秒);
- ⏱️ 用运动学公式 时长 = 距离 ÷ 速度,让动画以"你滑动时的速度"继续走完剩余距离;
- 🛡️ 加一个时长上限兜底,防止极速甩动时动画快到看不清。
下面逐步拆解,对应源码都在 MFSideMenu/MFSideMenuContainerViewController.m 中。
第一步:从 UIPanGestureRecognizer 中读取滑动速度
手势识别器 UIPanGestureRecognizer 提供了 velocityInView: 方法,返回手指在识别器视图坐标系中的瞬时速度(单位:点/秒)。MFSideMenu 在手势结束(UIGestureRecognizerStateEnded)时读取它,例如右侧滑动分支:
CGPoint velocity = [recognizer velocityInView:view];
CGFloat finalX = translatedPoint.x + (.35 * velocity.x);
见 MFSideMenu/MFSideMenuContainerViewController.m#L625-L648。
这里有个精妙的细节:.35 * velocity.x。它相当于把手指的轨迹向前投射 0.35 秒——即"如果手继续滑 0.35 秒,屏幕内容会走到哪里"。这个投射位置 finalX 用来做甩动手势判定:
BOOL showMenu = (finalX > viewWidth/2) || (finalX > self.leftMenuWidth/2);
- 投射位置过半屏(或超过菜单宽度的一半)→ 松手后打开菜单;
- 否则 → 回弹关闭。
这就是为什么轻轻一拨就能打开菜单,而慢慢拖一点松手就会弹回去——它判断的不是"滑了多远",而是"带着多少惯性"。左侧菜单的对称实现在 L678-L701。
第二步:运动学公式 t = d / v 计算动画时长
当手势结束且决定要完成开/合时,速度被存入内部属性 panGestureVelocity,随后进入统一的偏移动画入口,核心公式在这里:
- (CGFloat)animationDurationFromStartPosition:(CGFloat)startPosition
toEndPosition:(CGFloat)endPosition {
CGFloat animationPositionDelta = ABS(endPosition - startPosition);
CGFloat duration;
if(ABS(self.panGestureVelocity) > 1.0) {
// 延续用户滑动时的速度继续动画
duration = animationPositionDelta / ABS(self.panGestureVelocity);
} else {
// 没有滑动手势(如点击按钮),按默认时长比例计算
CGFloat menuWidth = MAX(_leftMenuWidth, _rightMenuWidth);
CGFloat animationPerecent = (animationPositionDelta == 0) ? 0
: menuWidth / animationPositionDelta;
duration = self.menuAnimationDefaultDuration * animationPerecent;
}
return MIN(duration, self.menuAnimationMaxDuration);
}
完整实现见 MFSideMenu/MFSideMenuContainerViewController.m#L776-L792。
拆开看,就是高中物理的 t = d ÷ v:
| 场景 | 公式 | 效果 |
|---|---|---|
| 甩动手势(速度 > 1 pt/s) | 剩余距离 ÷ 松手速度 | 滑得越快,动画越短,速度无缝衔接 |
| 点击按钮(速度 ≈ 0) | 默认时长 × 宽度比例 | 无速度信息时用固定基准节奏 |
用默认菜单宽度 270pt 举例(速度为松手瞬间值):
- 快速甩动,速度 900 pt/s → 时长 270 ÷ 900 = 0.3 秒
- 更快甩动,速度 1350 pt/s → 0.2 秒
- 慢速拖动,速度 400 pt/s → 0.675 秒 → 被上限钳制为 0.4 秒 🛡️
最后一行 MIN(duration, self.menuAnimationMaxDuration) 就是安全上限:即使甩出 2000 pt/s 的极限速度,动画也不会短到 0.13 秒让人看不清内容,最多钳制在 0.4 秒内完成。
关键参数默认值一览
这些默认值在 setDefaultSettings 中初始化(L77-L88),全部可以在运行时修改:
| 参数 | 默认值 | 作用 |
|---|---|---|
menuAnimationDefaultDuration |
0.2 秒 | 无滑动(点击打开)时的基准时长 |
menuAnimationMaxDuration |
0.4 秒 | 动画时长的硬上限,防"闪" |
.35(速度投射系数) |
— | 甩动判定中向前投射的秒数 |
1.0(速度阈值) |
— | 速度低于 1 pt/s 视为"没有滑动" |
menuWidth |
270 pt | 左右菜单宽度 |
参数声明及注释见 MFSideMenu/MFSideMenuContainerViewController.h#L48-L50,原作者的注释一语中的:
menu open/close animation duration -- user can pan faster than default duration, max duration sets the limit
还有一个容易被忽略的细节:动画完成后,panGestureVelocity 会被重置为 0(L735-L738)。也就是说,手势速度只对紧随其后的那一次动画生效,之后的按钮点击一定走默认时长分支,两条路径互不污染。
这套设计能带来什么体验
- 🚀 跟手性:松手瞬间,内容没有加速度突变,像是真的"脱手飞出去";
- ⚖️ 一致性:同样的剩余距离,甩得快就收得快,与用户直觉一致;
- 🛡️ 可控性:上限 0.4 秒保证了任何极端输入下动画都可见、可预期。
想亲自感受这套效果,可以运行仓库内的示例工程,例如基础演示 Demos/MFSideMenuDemoBasic/,集成方式则参考 README.mdown 中的一行 CocoaPods:
pod 'MFSideMenu'
总结:三行"物理"总结 MFSideMenu 的丝滑秘诀
- 读速度:松手时取
velocityInView:的瞬时速度,并用 0.35 秒投射判定开/合意图; - 算时长:
时长 = 剩余距离 ÷ 速度,让动画速度无缝继承手势速度; - 设上限:
MIN(duration, 0.4)钳制时长,点击等无速度场景回退到 0.2 秒基准。
对于任何想做好手势驱动的 iOS 动画的开发者,这 20 来行代码(animationDurationFromStartPosition:toEndPosition:)就是一个可以直接抄作业的范本:让物理规律替你调参,动画自然就是"丝滑"的。