SuperAPI AI 工具集

animate-expo

编程与开发

查看项目

更新于 10-20 08:36

技能介绍

用途

本技能用于在 React Native 和 Expo 项目中构建动画。它把“加个动效”的请求转化为经得起真机严格评审的实现,而非仅在模拟器或开发模式旗舰机上看起来正常。

移动端动画有三条前提:没有悬停,所有网页悬停提示须改为按压或位置反馈;存在两个运行时,React Native 运行时负责渲染和逻辑,UI 运行时逐帧执行 worklet;用户手指在元素上,手势是主要输入,可中断性与速度衔接是基线而非润色。

主要能力与构建顺序

  1. 判断是否该动画:按使用频率分档。每天 100 次以上的操作(标签切换、键盘开合、滚动、开关)不加动画;每天数十次仅做极轻微反馈(150ms 内)或不加;偶尔出现(弹层、模态、Toast)用标准动画;罕见或首次(成功态、空状态)才用“愉悦预算”。标签切换绝不用滑动,应设 animation: 'none'。
  2. 命名目的:用一词说明是反馈、空间一致性、状态指示、防止突兀、解释还是愉悦,无法命名则不构建。
  3. 选最简工具:无手势的状态变化用 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。
  4. 选属性:transform 和 opacity 免费,其余触发布局重算。绝对定位且无子元素可例外动画宽度。不要 scale(0),从 scale(0.9–0.97) + opacity: 0 开始。transform 数组顺序影响结果,translate 放前。Android 阴影用预阴影层透明度交叉淡化,不要动画 elevation 或 BlurView 强度。
  5. 定时或弹簧:有手指参与用弹簧,否则用定时。提供默认、回弹、弹层等弹簧配置,以及强 ease-out、ease-in-out、iOS 弹层曲线等缓动常量。UI 动画保持在 300ms 内,导航沿用平台默认。
  6. 保持在 JS 线程之外:手势或滚动中绝不 setState;不在 onUpdate 中每帧调度回 RN 运行时;不在渲染中读写共享值;使用 .get() / .set() 而非 .value;worklet 调用的函数首行加 'worklet'。
  7. 按压而非悬停:按下即反馈、松开提交;scale: 0.97 100–150ms;最小触控目标 44×44pt(Android 48dp);用 hitSlop 扩大热区;自定义设计应用中双平台统一缩放比单平台波纹更一致。
  8. 触觉:按场景使用 selectionAsync、impactAsync、notificationAsync;与视觉同帧、每次操作一次、绝不作为唯一反馈;worklet 中需 scheduleOnRN 调度。
  9. 减弱动态与无障碍:用 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。