用途
本技能用于在 React Native 和 Expo 项目中构建动画。它把“加个动效”的请求转化为经得起真机严格评审的实现,而非仅在模拟器或开发模式旗舰机上看起来正常。
移动端动画有三条前提:没有悬停,所有网页悬停提示须改为按压或位置反馈;存在两个运行时,React Native 运行时负责渲染和逻辑,UI 运行时逐帧执行 worklet;用户手指在元素上,手势是主要输入,可中断性与速度衔接是基线而非润色。
主要能力与构建顺序
- 判断是否该动画:按使用频率分档。每天 100 次以上的操作(标签切换、键盘开合、滚动、开关)不加动画;每天数十次仅做极轻微反馈(150ms 内)或不加;偶尔出现(弹层、模态、Toast)用标准动画;罕见或首次(成功态、空状态)才用“愉悦预算”。标签切换绝不用滑动,应设
animation: 'none'。 - 命名目的:用一词说明是反馈、空间一致性、状态指示、防止突兀、解释还是愉悦,无法命名则不构建。
- 选最简工具:无手势的状态变化用 Reanimated CSS transition;循环或多阶段用 CSS animation 关键帧;挂载/卸载或列表重排用布局动画;手指触碰或滚动派生用
useSharedValue+ Gesture +useAnimatedStyle;页面切换用 Expo Router 原生栈;底部表用presentation: 'formSheet';标签栏用 NativeTabs;上下文菜单用Link.Menu/Link.Preview;折叠大标题用headerLargeTitleEnabled;下拉刷新用RefreshControl;键盘跟随用react-native-keyboard-controller;插画与庆祝用 Lottie;超大场景用 Skia。依赖通过npx expo install <package>安装以匹配 SDK。 - 选属性:
transform和opacity免费,其余触发布局重算。绝对定位且无子元素可例外动画宽度。不要scale(0),从scale(0.9–0.97)+opacity: 0开始。transform 数组顺序影响结果,translate 放前。Android 阴影用预阴影层透明度交叉淡化,不要动画 elevation 或 BlurView 强度。 - 定时或弹簧:有手指参与用弹簧,否则用定时。提供默认、回弹、弹层等弹簧配置,以及强 ease-out、ease-in-out、iOS 弹层曲线等缓动常量。UI 动画保持在 300ms 内,导航沿用平台默认。
- 保持在 JS 线程之外:手势或滚动中绝不 setState;不在 onUpdate 中每帧调度回 RN 运行时;不在渲染中读写共享值;使用
.get()/.set()而非.value;worklet 调用的函数首行加'worklet'。 - 按压而非悬停:按下即反馈、松开提交;
scale: 0.97100–150ms;最小触控目标 44×44pt(Android 48dp);用hitSlop扩大热区;自定义设计应用中双平台统一缩放比单平台波纹更一致。 - 触觉:按场景使用
selectionAsync、impactAsync、notificationAsync;与视觉同帧、每次操作一次、绝不作为唯一反馈;worklet 中需scheduleOnRN调度。 - 减弱动态与无障碍:用
useReducedMotion或ReduceMotion.System,减弱而非归零,保留透明度与颜色变化,去掉位移、缩放、视差与过冲;屏幕切换改为animation: 'fade';文字缩放需用onLayout测量,勿动画到硬编码高度。
使用方式
按 1 至 9 的顺序执行,步骤 1 和 2 是前置门槛。代码即交付物,完成后用几行说明门槛结果、所用工具/属性/曲线/线程,以及需在真机上感受检查的要点。
适用场景与限制
适用于 React Native / Expo 的 UI 动效、手势交互、页面切换与触觉反馈设计。限制与前提:Reanimated 4 需要新架构;Expo 项目由 babel-preset-expo 自动配置插件;GestureHandlerRootView 必须包裹应用;手感只能在发布构建与最慢支持设备上验证,Expo Go 和模拟器不算数;ProMotion 需设置 CADisableMinimumFrameDurationOnPhone。完整配方(按压反馈、拖拽关闭弹层、滑动删除、折叠头、列表入场、键盘同步、标签指示器、屏幕切换)见 RECIPES.md。