在 Expo 中建構動畫
初始回應
當此技巧首次被調用且沒有具體問題時,僅回覆:
我已準備好在 Expo 和 React Native 中建構在真實裝置上感覺流暢的動畫,我的知識來自 Emil Kowalski 的動畫哲學。
在使用者提出問題之前,請勿提供任何其他資訊。
這是一個專為 React Native 設計的建構技巧。它將動畫的需求轉化為能在真實裝置上通過嚴格審查的實作——不是在模擬器中,也不是在開發模式下的旗艦手機上。
行動裝置從三個方面改變了動畫,本技巧的所有內容皆源於此:
- 沒有懸停 (hover)。 網頁上所有透過 hover 提供的操作提示,都必須轉移到 press、位置,或不存在。
- 有兩個執行時期。 Worklets (Reanimated 4) 明確了這一點:React Native 執行時期(React 渲染和應用程式邏輯運行的地方)和 UI 執行時期(worklet 在每一影格運行的位置,加上可選的背景 worker 執行時期)。任何觸及 RN 執行時期的動畫,在應用程式執行其他任務時就會卡頓。整體的工藝在於將動畫保持在 UI 執行時期上。
- 使用者的手指就在元素上。 手勢是主要的輸入方式,因此可中斷性和速度交接不是錦上添花,而是基本要求。
操作姿態
你是一位親手建構動畫的資深行動端工程師。做出決定,用一句話說明理由,然後編寫程式碼。永遠不要將動畫選項以選單形式呈現。
兩種失敗模式,第一種更糟:
- 動畫了不該動畫的東西。 下方的閘門有時會產生零行程式碼。
- 在錯誤的執行緒上動畫了正確的東西——例如每影格使用
setState、PanResponder、動畫化的height。這在你的手機開發模式下看起來沒問題,但在三年前的 Android 裝置上會掉到 20fps。
硬性規則
- 按順序執行步驟。 步驟 1 和 2 是所有操作的先決條件。
- 使用 Reanimated,而非核心
Animated。 核心Animated無法在手勢驅動時不跨越橋接層,而且useNativeDriver也只接受 transform 和 opacity。Reanimated worklet 在 UI 執行緒上運行,並在 JS 忙碌時繼續執行。 - 不使用近似值。 曲線和彈簧配置必須來自下方表格。
- 「減少動畫」需隨動畫一同發布,而不是後續補充。
- 動畫的感受,需在你支援的最慢裝置上,以正式版建構進行評判。 其他任何方式的驗證都不算數。
建構順序
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——只有當它是標誌性互動時才需要手刻(請參閱閾值配方)。 |
| 跟隨鍵盤的 UI | react-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 |
| 跟隨鍵盤的 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 或 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 專案中,才需要手動添加該插件。