丝滑动画的物理学:MFSideMenu如何根据滑动速度精确计算侧边栏动画时长

原创2026-10-31 22:44:571,819 阅读
文章标签:UI库/组件

丝滑动画的物理学:MFSideMenu如何根据滑动速度精确计算侧边栏动画时长

MFSideMenu 是一款经典的开源 iOS 侧边栏菜单(Side Menu)库,用于快速实现 Facebook 风格的左右滑出菜单。它最让人称道的一点,是菜单跟手、松手后动画"丝滑"——秘诀就在于它能根据滑动手指的实时速度,用一条物理公式精确计算动画时长。本文带你拆解这套机制。

为什么侧边栏动画会"丝滑"?

想象你用手推一扇门,松手后门的惯性速度与你松手瞬间的推门速度一致,门才会"顺";如果松手后门突然加速或减速,就会有一种"被电了一下"的割裂感。

MFSideMenu 的做法正是如此:

  1. 🖐️ 捕捉松手瞬间的速度(点/秒);
  2. ⏱️ 用运动学公式 时长 = 距离 ÷ 速度,让动画以"你滑动时的速度"继续走完剩余距离;
  3. 🛡️ 加一个时长上限兜底,防止极速甩动时动画快到看不清。

下面逐步拆解,对应源码都在 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 的丝滑秘诀

  1. 读速度:松手时取 velocityInView: 的瞬时速度,并用 0.35 秒投射判定开/合意图;
  2. 算时长:时长 = 剩余距离 ÷ 速度,让动画速度无缝继承手势速度;
  3. 设上限:MIN(duration, 0.4) 钳制时长,点击等无速度场景回退到 0.2 秒基准。

对于任何想做好手势驱动的 iOS 动画的开发者,这 20 来行代码(animationDurationFromStartPosition:toEndPosition:)就是一个可以直接抄作业的范本:让物理规律替你调参,动画自然就是"丝滑"的。

登录后查看全文
MFSideMenu