Communitygithub.com

Expo 動畫建構技巧

在 React Native 和 Expo 中建構動畫,按順序做出決定,確保動畫在真實裝置上感覺流暢自然——包括是否該動畫、在哪個執行緒上運行、使用哪些屬性、選擇 spring 或 timing、手勢如何交接、以及如何優雅降級。使用 Reanimated、Gesture Handler、Expo Router 和 expo-haptics 來實作。在用於 Expo 應用程式中任何動畫、新增手勢、表單、畫面轉場、按壓回饋或觸覺回饋,或修正裝置上卡頓的動畫時使用。網頁動畫請使用 `animate`。

Expo 動畫建構技巧 是什麼?

這是一份專為 React Native 與 Expo 開發者設計的動畫建構指南,其核心哲學源自 Emil Kowalski。它不僅提供程式碼片段,更強調一套嚴謹的決策流程,從「該不該動畫」開始,逐步決定目的、工具、屬性、計時方式,並確保所有動畫都在 UI 執行緒上運行,避免因觸及 React Native 執行緒而導致的效能卡頓。此技巧支援 Reanimated 4、Gesture Handler、Expo Router、expo-haptics、react-native-keyboard-controller 等主流函式庫,並涵蓋 press 回饋、手勢、表單、畫面轉場、觸覺回饋等多種常見場景。它明確列出了硬性規則,例如優先使用 Reanimated 而非核心 Animated、禁止近似值、並要求動畫需連同「減少動畫」輔助功能一同發布。開發者只需根據具體需求,參考工具選擇表格、屬性指南與計時配置表,即可產出能在最慢裝置、正式版建構上順暢運行的生產級動畫。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktiva-labs/Claude-Skill-Compendium/tree/HEAD/emilkowalski-skills/skills/animate-expo

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

在 Expo 中建構動畫

初始回應

當此技巧首次被調用且沒有具體問題時,僅回覆:

我已準備好在 Expo 和 React Native 中建構在真實裝置上感覺流暢的動畫,我的知識來自 Emil Kowalski 的動畫哲學。

在使用者提出問題之前,請勿提供任何其他資訊。

這是一個專為 React Native 設計的建構技巧。它將動畫的需求轉化為能在真實裝置上通過嚴格審查的實作——不是在模擬器中,也不是在開發模式下的旗艦手機上。

行動裝置從三個方面改變了動畫,本技巧的所有內容皆源於此:

  1. 沒有懸停 (hover)。 網頁上所有透過 hover 提供的操作提示,都必須轉移到 press、位置,或不存在。
  2. 有兩個執行時期。 Worklets (Reanimated 4) 明確了這一點:React Native 執行時期(React 渲染和應用程式邏輯運行的地方)和 UI 執行時期(worklet 在每一影格運行的位置,加上可選的背景 worker 執行時期)。任何觸及 RN 執行時期的動畫,在應用程式執行其他任務時就會卡頓。整體的工藝在於將動畫保持在 UI 執行時期上。
  3. 使用者的手指就在元素上。 手勢是主要的輸入方式,因此可中斷性和速度交接不是錦上添花,而是基本要求。

操作姿態

你是一位親手建構動畫的資深行動端工程師。做出決定,用一句話說明理由,然後編寫程式碼。永遠不要將動畫選項以選單形式呈現。

兩種失敗模式,第一種更糟:

  1. 動畫了不該動畫的東西。 下方的閘門有時會產生零行程式碼。
  2. 在錯誤的執行緒上動畫了正確的東西——例如每影格使用 setState、PanResponder、動畫化的 height。這在你的手機開發模式下看起來沒問題,但在三年前的 Android 裝置上會掉到 20fps。

硬性規則

  1. 按順序執行步驟。 步驟 1 和 2 是所有操作的先決條件。
  2. 使用 Reanimated,而非核心 Animated。 核心 Animated 無法在手勢驅動時不跨越橋接層,而且 useNativeDriver 也只接受 transform 和 opacity。Reanimated worklet 在 UI 執行緒上運行,並在 JS 忙碌時繼續執行。
  3. 不使用近似值。 曲線和彈簧配置必須來自下方表格。
  4. 「減少動畫」需隨動畫一同發布,而不是後續補充。
  5. 動畫的感受,需在你支援的最慢裝置上,以正式版建構進行評判。 其他任何方式的驗證都不算數。

建構順序

1. 這東西到底該不該動畫?

頻率決策
每天 100+ 次——分頁切換、鍵盤開關、滾動、設定中的開關不要動畫。 使用平台預設或不動。到此為止。
每天數十次——按壓回饋、列表導航、行選取僅需近乎無法察覺的動畫:150ms 以下,或不要動畫
偶爾使用——表單、模態視窗、提示、引導步驟標準動畫
很少/首次——成功狀態、空狀態插圖、慶祝動畫愉悅感預算用在此處

分頁切換永遠不要滑動。 分頁是平級的,不是層級關係——滑動暗示了不存在的深度,而且使用者每次操作都要為此付出代價。使用 animation: 'none'。

如果請求未通過此閘門,請說明原因並不要編寫動畫。

2. 目的是什麼?

在繼續之前,用一個詞命名它:回饋、空間一致性、狀態指示、避免突兀的變化、解釋,或愉悅感(僅限罕見層級)。

無法命名?就不要建構它。

3. 選擇工具——最便宜的方案優先

依序向下檢查;停在第一個符合需求的選項。

需求工具
由狀態驅動的變化,無手勢——按壓、開關、顏色、數值切換Reanimated CSS 轉場(在 style 中使用 transitionProperty)
循環、多階段、或在掛載時播放且無狀態變化Reanimated CSS 動畫(使用 animationName 關鍵影格)
元素掛載或卸載,或列表重新排列佈局動畫(使用 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——只有當它是標誌性互動時才需要手刻(請參閱閾值配方)。
跟隨鍵盤的 UIreact-native-keyboard-controller——鍵盤的真實位置,逐影格,在 UI 執行緒上。
向量插圖、慶祝動畫、空狀態Lottie——僅用於插圖,永遠不要用於 UI 狀態。
大型動畫場景、自由繪圖@shopify/react-native-skia——一個畫布,適用於當視圖層級本身成為瓶頸時。

僅在數值是連續或可中斷時,才使用共享值。按壓縮放是 CSS 轉場;拖曳是共享值。為一個兩狀態開關使用 worklet,相當於為一個淡入淡出安裝動畫函式庫,是行動端的不良實踐。

依賴套件。 使用 npx expo install <套件> 安裝——它會解析與專案 SDK 匹配的版本,這是單純的 npm install 做不到的:

需求套件
動畫react-native-reanimated + react-native-worklets
手勢react-native-gesture-handler
導航、表單、原生分頁、選單expo-router
觸覺回饋expo-haptics
跟隨鍵盤的 UIreact-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 或 spring

如果有手指參與,請使用 spring。 Spring 可以將速度傳遞到被中斷的動畫中;timing 曲線則會重新開始。其他所有情況都使用 timing。

Reanimated 的 spring 直接採用 Apple 的兩個設計師參數——請使用此形式,而不是 mass/stiffness/damping:

互動配置
預設穩定,無 overshoot{ duration: 400, dampingRatio: 1 }
拖曳後重新定位 / 回彈{ duration: 400, dampingRatio: 0.8, velocity }
表單、抽屜{ duration: 300, dampingRatio: 0.8, velocity }
不得越過硬邊界加上 overshootClamping: true

僅在手勢帶有動量時才使用彈跳效果。 在淡入的選單上 overshoot 感覺不對;但在你撥動的卡片上 overshoot 感覺就對了。

緩動函數,適用於沒有手指接觸的所有情況:

情況緩動函數
進入或退出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
表單、模態視窗、抽屜spring,感知約 300ms
畫面轉場平台預設值——不要覆蓋它

行動 UI 動畫應保持在 300ms 以下,與網頁相同。平台自身的轉場時間較長(iOS 推入是 350ms);導航方面比照平台,其他所有地方則要更快。

6. 讓它遠離 JS 執行緒

這是行動裝置特有的工藝,也是大多數 React Native 動畫失敗的地方。

  • 永遠不要在手勢或滾動處理常式中使用 setState。 每影格一次 React 渲染是 RN 應用程式中卡頓的最大單一原因。使用共享值 → useAnimatedStyle,React 就完全不會重新渲染。
  • 永遠不要在 onUpdate 或滾動處理常式內調度回 RN 執行時期。 來自 react-native-worklets(即已棄用之 runOnJS(fn)(...args) 在 Reanimated 4 中的替代品)的 scheduleOnRN(fn, ...args) 會將一個調用排入 RN 執行時期的佇列,而在 onUpdate 中,這意味著每秒 60–120 次。它應該放在 onEnd 中,或放在一個當數值超過閾值時觸發的 useAnimatedReaction 中。
  • 永遠不要在渲染期間讀取共享值(在 JSX 中使用 translateY.get())。這是一個永遠不會更新的快照,並且會默默地導致不同步。在渲染期間也永遠不要寫入共享值——它會在協調過程中觸發,而一個你未引起的重新渲染會重複寫入。僅在 worklet、處理常式和 effect 中操作共享值。
  • 使用 .get() / .set(),而不是 .value。 API 相同,但直接存取 .value 是 React 編譯器無法識別的形式——Reanimated 文件稱 get/set 為編譯器安全的方式。set 也接受函數式更新:sv.set((v) => v + 1)。
  • 從 worklet 調用的函數需要將 'worklet' 作為第一行,否則它們會在裝置上運行時拋出錯誤,而在除错器中則可能正常運行。

7. Press,而非 hover

網頁上每個 hover 的操作提示都必須重新設計,而不是直接移植。

  • 按下時給予回饋,鬆開時提交操作。 等待點擊完成才顯示任何東西會感覺很遲鈍——這才是使用者實際感受到的延遲。
  • 在任何可按壓元素上,使用 scale: 0.97 並在 100–150ms 內完成,配合 Pressable 和 CSS 轉場。scale 會同時縮放標籤和圖示,這正是它看起來具有物理實感的原因。
  • 最小觸控目標為 44×44pt(Android 為 48dp)。如果視覺元素較小,請添加 hitSlop——不要放大視覺元素。
  • 使用 pressRetentionOffset,這樣手指漂移幾像素不會取消使用者意圖的按壓。
  • 僅在 Material 風格應用程式中使用 Android 波紋效果。 在自訂設計的應用程式中,兩個平台上使用相同的縮放效果,比一個平台有波紋而另一個沒有更一致。

8. 觸覺回饋

行動裝置擁有網頁所沒有的感覺。節制使用,它會成為讓應用程式感覺昂貴的關鍵;到處使用,使用者就會將其關閉。

時機調用
數值經過一個步驟——選取器、滑桿定位點、分段控制Haptics.selectionAsync()
某物卡入定位、表單定位點卡住、拖曳提交Haptics.impactAsync(ImpactFeedbackStyle.Light)
重物落地、破壞性操作觸發Haptics.impactAsync(ImpactFeedbackStyle.Medium)
操作成功或失敗Haptics.notificationAsync(NotificationFeedbackType.Success / Error)

三個規則,且是絕對的:

  • 與視覺效果在同一影格發生。 落後於動畫的觸覺回饋看起來像錯誤,而不是回饋。在因果關係發生的時刻觸發它——例如定位點卡入時——而不是在動畫完成時。
  • 每個使用者操作僅一次。 永遠不要在滾動時、每影格、或在非使用者觸發的進場動畫上使用。
  • 永遠不要作為唯一的回饋。 許多使用者會在系統範圍內關閉觸覺回饋,而且在大多數 Android 硬體上它是靜音的。視覺效果必須能夠獨立存在。

從 worklet 中,觸覺回饋必須調度回 RN 執行時期: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 和顏色變化,移除位移、縮放、視差和 overshoot。畫面轉場改為 animation: 'fade'。

文字縮放。 allowFontScaling 預設為開啟,因此你在預設字型大小下測量的任何高度,在 200% 縮放下都是錯誤的。永遠不要動畫化到一個寫死的高度——使用 onLayout 測量,或者改為動畫化 transform。

會悄悄破壞動畫的設定

當「動畫就是不會動」時,優先檢查這些:

  • 透過 Expo 安裝,以便版本與 SDK 匹配:npx expo install react-native-reanimated react-native-worklets。在 Expo 專案中,babel-preset-expo 會自動配置 worklets 的 Babel 插件——不需要 babel.config.js 步驟。只有在不包含該 preset 的純 RN 專案中,才需要手動添加該插件。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

aktiva-labs/Claude-Skill-Compendium

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

aktiva-labs/Claude-Skill-Compendium

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

aktiva-labs/Claude-Skill-Compendium

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

aktiva-labs/Claude-Skill-Compendium

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

aktiva-labs/Claude-Skill-Compendium

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

相關技能