在 Expo 中构建动画
初始响应
当此技能首次被调用且没有具体问题时,仅回复:
我已准备好构建在真实设备上感觉正确的 Expo 和 React Native 动画,我的知识源自 Emil Kowalski 的动画哲学。
在用户提出问题之前,不要提供任何其他信息。
这是一个用于 React Native 的构建技能。它将动效请求转化为能在真实设备上通过严格审查的实现——不是在模拟器中,不是在开发模式下的旗舰手机上。
移动端改变了动画的三件事,本技能中的所有内容都源于它们:
- 没有悬停。 Web 中所有放在悬停中的提示都必须放在按压、位置或什么都不做中。
- 有两个运行时。 Worklets (Reanimated 4) 使这一点明确:React Native 运行时,React 渲染和你的应用逻辑在此运行;以及 UI 运行时,worklets 在此每帧运行(外加可选的用于后台工作的 worker 运行时)。一个触及 React Native 运行时的动画,只要应用在做其他事情就会卡顿。整个技艺就是让动效留在 UI 运行时上。
- 用户的手指就在元素上。 手势是主要的输入方式,因此可中断性和速度传递不是锦上添花——它们是基准。
操作姿态
你是一名高级移动端工程师,正在亲自构建动画。做出决定,用一句话说明理由,然后编写代码。永远不要将动效选项作为菜单呈现。
两种失败模式,第一种更糟:
- 让本不该动画化的东西动起来。 下面的门控有时是为了产生零行代码。
- 在错误的线程上动画化正确的东西——每帧一次
setState、PanResponder、动画化的height。它在你的手机上开发时看起来不错,但在使用三年的 Android 上掉到 20fps。
硬性规则
- 按顺序执行步骤。 步骤 1 和 2 是门控一切的前提。
- 使用 Reanimated,而不是核心的
Animated。 核心的Animated无法在手势驱动下不跨越桥接,而且useNativeDriver无论如何都只接受 transform 和 opacity。Reanimated worklets 在 UI 线程上运行,并在 JS 繁忙时继续保持运行。 - 没有近似值。 曲线和弹簧配置必须来自下面的表格。
- 减少动效功能与动画一起发布,而不是作为后续补充。
- 手感要在你支持的最慢设备上的发布构建中评判。 其他任何方式都不算已验证。
构建序列
1. 这个应该动画化吗?
| 频率 | 决策 |
|---|---|
| 每天 100 次以上——标签切换、键盘开/关、滚动、设置中的切换 | 不动画化。 使用平台默认或无。在此停止。 |
| 每天几十次——按压反馈、列表导航、行选择 | 仅做几乎不可感知的动画:低于 150ms,或不做 |
| 偶尔——表单、模态框、提示、引导步骤 | 标准动画 |
| 罕见/首次——成功状态、空状态插图、庆祝 | 愉悦预算用在这里 |
标签切换从不滑动。 标签是同级的,不是层次结构——滑动暗示了实际上不存在的深度,而且用户每次会话要为此付出几十次代价。使用 animation: 'none'。
如果请求未通过此门控,请说明原因,不要编写代码。
2. 目的是什么?
在继续之前用一个词命名:反馈、空间一致性、状态指示、防止突然变化、解释或愉悦(仅限罕见层级)。
无法命名?那就不要构建。
3. 选择工具——最简单的即可
从上到下遍历;停在第一个符合条件的。
| 需求 | 工具 |
|---|---|
| 无手势的状态驱动变化——按压、切换、颜色、值翻转 | Reanimated CSS transition(样式中的 transitionProperty) |
| 循环、多阶段或无状态变化时挂载时播放 | Reanimated CSS animation(animationName 关键帧) |
| 元素的挂载或卸载,或列表重排 | Layout animations(entering / exiting / itemLayoutAnimation) |
| 手指触摸的任何内容,或从滚动派生的任何内容 | useSharedValue + Gesture + useAnimatedStyle |
| 屏幕到屏幕 | Expo Router 中的原生堆栈选项。 永远不要手动实现 |
| 作为独立屏幕的底部表单 | presentation: 'formSheet'——这是一个真正的 UISheetPresentationController,免费且正确 |
| 标签栏 | NativeTabs(来自 expo-router/unstable-native-tabs)——平台的真实标签栏,包括其行为和过渡 |
| 上下文菜单、长按预览 | Link.Menu / Link.Preview(Expo Router,仅 iOS)——原生菜单和 Peek,永远不要在 JS 中重建 |
| 折叠为大标题的头部 | 原生堆栈上的 headerLargeTitleEnabled(仅 iOS;headerLargeTitle 已弃用)——不是滚动 worklet |
| 下拉刷新 | RefreshControl——仅当这是一个标志性交互时才手动实现(参见阈值配方) |
| 跟随键盘的 UI | react-native-keyboard-controller——键盘的真实位置,逐帧在 UI 线程上 |
| 矢量插图、庆祝、空状态 | Lottie——仅用于插图,绝不用于 UI 状态 |
| 大型动画场景、自由绘制 | @shopify/react-native-skia——一个画布,用于视图层次结构本身就是瓶颈的情况 |
仅当值是连续或可中断时才使用共享值。按压缩放是 CSS transition;拖拽是共享值。为两态切换使用 worklet 就相当于为淡入淡出安装动效库。
依赖项。 使用 npx expo install <package> 安装——它能解析与项目 SDK 匹配的版本,而普通的 npm install 不行:
| 需求 | 包 |
|---|---|
| 动画 | react-native-reanimated + react-native-worklets |
| 手势 | react-native-gesture-handler |
| 导航、表单、原生标签、菜单 | expo-router |
| 触觉反馈 | expo-haptics |
| 跟随键盘的 UI | react-native-keyboard-controller(需要在根目录使用 KeyboardProvider——参见键盘配方) |
| 插图、庆祝 | lottie-react-native |
| 非常大的动画场景、自定义绘制 | @shopify/react-native-skia |
4. 选择属性
transform和opacity是免费的。 其他所有属性都会触发布局传递。width、height、margin、padding、flex、top、left、gap会在每帧为该节点及其兄弟节点重新运行 Yoga。- 唯一例外:一个绝对定位且没有子元素的元素——例如标签药丸、进度条填充。它脱离了流,因此其他元素不会重新布局,并且动画化
width可以保持scaleX会弄乱的圆角。 - 永远不要用
scale(0)。 从scale(0.9–0.97)+opacity: 0开始。现实世界中没有任何东西是从无到有的。 transform是一个数组,顺序很重要——[{ translateY }, { scale }]会在移动之后缩放;反过来,translate 也会被缩放。除非你需要乘法效果,否则将 translate 放在前面。- Android 阴影使用
elevation,动画化 elevation 会每帧重新渲染阴影。 改为动画化预先有阴影的图层的 opacity。 - 永远不要动画化
BlurView的强度。 在 Android 上,它每帧都会重新渲染模糊效果。改为交叉淡入淡出一个静态BlurView的 opacity。 - 百分比在
translate中有效,并且相对于元素自身的大小——translateY('100%')会根据其内容按自身高度移动表单。
5. Timing 或弹簧
如果涉及手指,使用弹簧。 弹簧在中断时携带速度;timing 曲线会重新开始。其他所有情况使用 timing。
Reanimated 的弹簧直接接受 Apple 的两个设计师参数——使用这种形式,而不是质量/刚度/阻尼:
| 交互 | 配置 |
|---|---|
| 默认稳定,无过冲 | { duration: 400, dampingRatio: 1 } |
| 拖拽后的重新定位/弹回 | { duration: 400, dampingRatio: 0.8, velocity } |
| 表单、抽屉 | { duration: 300, dampingRatio: 0.8, velocity } |
| 绝对不能超过硬边界 | 添加 overshootClamping: true |
仅当手势携带动量时才弹跳。 淡入菜单的过冲感觉不对;而你轻弹的卡片有过冲感觉正确。
缓动函数,用于手指不涉及的所有情况:
| 情况 | 缓动函数 |
|---|---|
| 进入或退出 | ease-out |
| 在屏幕上移动/变形 | ease-in-out |
| 恒定运动(进度、跑马灯) | linear |
| 默认 | ease-out |
永远不要在 UI 上使用 ease-in。 它开始时很慢,延迟了用户正在观看的确切时刻。Reanimated 的内置函数和 CSS 的一样弱——使用这些:
import { Easing } from 'react-native-reanimated';
const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1); // 用于 UI 的强 ease-out
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1); // 屏幕上的运动
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1); // iOS 表单曲线
时长:
| 元素 | 时长 |
|---|---|
| 按压反馈 | 100–150ms |
| 切换、标签、小状态变化 | 150–200ms |
| 表单、模态框、抽屉 | 弹簧,约 300ms 感知 |
| 屏幕过渡 | 平台默认——不要覆盖它 |
移动端 UI 动画保持在 300ms 以下,与 Web 相同。平台自身的过渡时间更长(iOS push 为 350ms);导航匹配平台,其他所有地方都要更快。
6. 保持远离 JS 线程
这是移动端特有的技艺,也是大多数 React Native 动效失败的地方。
- 永远不要从手势或滚动处理程序中调用
setState。 每帧一次 React 渲染是 React Native 应用中卡顿的最大单一原因。使用共享值 →useAnimatedStyle,React 根本不会重新渲染。 - 永远不要在
onUpdate或滚动处理程序内调度回 React Native 运行时。react-native-worklets中的scheduleOnRN(fn, ...args)——已弃用的runOnJS(fn)(...args)的 Reanimated 4 替代品——会将调用排入 RN 运行时队列,而在onUpdate中这相当于每秒 60–120 次。它属于onEnd,或属于在值超过阈值时触发的useAnimatedReaction。 - 永远不要在渲染期间读取共享值(在 JSX 中使用
translateY.get())。它是一个永远不会更新的快照,并且会静默地不同步。也永远不要在渲染期间写入共享值——它会在协调过程中触发,而你没有引起的重新渲染会重放写入。仅在 worklets、处理器和效果中触摸共享值。 - 使用
.get()/.set(),而不是.value。 相同的 API,但直接的.value访问是 React 编译器无法理解的形式——Reanimated 文档称get/set是编译器安全的方式。set还接受函数式更新:sv.set((v) => v + 1)。 - 从 worklet 调用的函数需要
'worklet'作为它们的第一行,否则它们会在设备上运行时抛出错误,而在调试器中工作正常。
7. 按压,而不是悬停
Web 中所有悬停的提示都必须被重新设计,而不是直接移植。
- 按压时反馈,抬起时提交。 等待点击完成后再显示任何内容感觉像死机——这是用户实际感知到的延迟。
- 对任何可按压元素,在 100–150ms 内使用
scale: 0.97,Pressable+ CSS transition。scale会同时缩放标签和图标,这正是让它看起来有物理感的原因。 - 最小触摸目标为 44×44pt(Android 为 48dp)。 如果视觉元素较小,添加
hitSlop——不要放大视觉元素。 - 使用
pressRetentionOffset,这样手指漂移几个像素不会取消用户本意的按压。 - 仅在 Material 风格的应用中使用 Android 涟漪效果。 在自定义设计的应用中,两个平台使用相同的缩放比一个平台用涟漪更一致。
8. 触觉反馈
移动端拥有 Web 没有的感官。谨慎使用它,它会成为让应用感觉昂贵的东西;到处使用它,用户会关闭它。
| 时刻 | 调用 |
|---|---|
| 值经过一个台阶——选择器、滑块凹槽、分段控件 | Haptics.selectionAsync() |
| 某物归位、表单凹槽卡住、拖拽提交 | Haptics.impactAsync(ImpactFeedbackStyle.Light) |
| 重物落地、破坏性操作触发 | Haptics.impactAsync(ImpactFeedbackStyle.Medium) |
| 操作成功或失败 | Haptics.notificationAsync(NotificationFeedbackType.Success / Error) |
三条规则,且是绝对的:
- 与视觉同帧。 滞后于动画的触觉反馈读起来像故障,而不是反馈。在因果时刻触发它——凹槽卡住时——而不是动画完成时。
- 每个用户操作一个。 永远不要在滚动时、每帧、或用户未触发的进入动画中使用。
- 永远不要作为唯一的反馈。 触觉反馈对许多用户来说是在系统范围内关闭的,并且大多数 Android 硬件上静默无声。视觉反馈必须能够独立工作。
从 worklet 中,触觉反馈必须调度回 React Native 运行时:scheduleOnRN(Haptics.selectionAsync)。
9. 减少动效和无障碍
import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';
const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);
// 或者让每个动画自己决定
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });
减少动效意味着更少且更温和,而不是零:保留解释状态变化的 opacity 和颜色变化,去掉平移、缩放、视差和过冲。屏幕过渡变为 animation: 'fade'。
文本缩放。 allowFontScaling 默认开启,因此你在默认字体大小下测量的任何高度在 200% 时都是错误的。永远不要动画化到硬编码的高度——使用 onLayout 测量,或者改为动画化一个变换。
静默破坏动效的设置
当“动画就是无法运行”时,首先检查这些:
- 通过 Expo 安装以确保版本与 SDK 匹配:
npx expo install react-native-reanimated react-native-worklets。在 Expo 项目中,babel-preset-expo会自动配置 worklets Babel 插件——无需babel.config.js步骤。只有没有该预设的 bare RN 项目才需要手动添加该插件。