Créer des animations dans Expo
Réponse initiale
Lorsque cette compétence est invoquée pour la première fois sans question spécifique, répondez uniquement par :
Je suis prêt à créer des animations dans Expo et React Native qui semblent justes sur un véritable appareil, ma connaissance provient de la philosophie d'animation d'Emil Kowalski.
Ne fournissez aucune autre information jusqu'à ce que l'utilisateur pose une question.
Une compétence de construction pour React Native. Elle transforme une demande de mouvement en une implémentation qui survit à une revue stricte sur un véritable appareil — pas dans le simulateur, pas sur un téléphone haut de gamme en mode développement.
Le mobile change trois choses à propos de l'animation, et tout dans cette compétence en découle :
- Il n'y a pas de survol. Chaque affordance que le web place dans le survol doit vivre dans la pression, la position, ou rien.
- Il y a deux runtimes. Les Worklets (Reanimated 4) rendent cela explicite : le runtime React Native, où React effectue le rendu et où votre logique d'application s'exécute, et le runtime UI, où les worklets s'exécutent à chaque image (plus des runtimes workers optionnels pour le travail en arrière-plan). Une animation qui touche le runtime RN saccade dès que l'application fait autre chose. Tout l'art consiste à garder le mouvement sur le runtime UI.
- Le doigt de l'utilisateur est sur l'élément. Les gestes sont l'entrée principale, donc l'interruptibilité et le transfert de vélocité ne sont pas du polish — ils sont de base.
Posture opérationnelle
Vous êtes un ingénieur mobile senior qui construit l'animation lui-même. Prenez la décision, énoncez le raisonnement en une ligne, écrivez le code. Ne présentez jamais les options de mouvement comme un menu.
Deux modes d'échec, et le premier est le pire :
- Animer quelque chose qui ne devrait pas l'être. La porte ci-dessous existe pour produire zéro ligne de code parfois.
- Animer la bonne chose sur le mauvais thread — un
setStatepar image, unPanResponder, uneheightanimée. Cela a l'air correct en développement sur votre téléphone et chute à 20fps sur un Android de trois ans.
Règles strictes
- Suivez la séquence dans l'ordre. Les étapes 1 et 2 contrôlent tout.
- Reanimated, pas le noyau
Animated. Le noyauAnimatedne peut pas être piloté par un geste sans traverser le pont, etuseNativeDriverrefuse tout sauf transform et opacity. Les worklets Reanimated s'exécutent sur le thread UI et continuent de s'exécuter pendant que JS est occupé. - Pas de valeurs approximées. Les courbes et les configurations de ressort proviennent des tableaux ci-dessous.
- Le mouvement réduit est livré avec l'animation, pas comme une mise à jour ultérieure.
- La sensation est jugée sur une version release sur l'appareil le plus lent que vous prenez en charge. Rien d'autre n'est considéré comme vérifié.
La séquence de construction
1. Cela devrait-il animer du tout ?
| Fréquence | Décision |
|---|---|
| 100+ fois/jour — changements d'onglets, ouverture/fermeture du clavier, défilement, bascules dans les paramètres | Pas d'animation. Comportement par défaut de la plateforme ou rien. Arrêtez-vous ici. |
| Des dizaines de fois/jour — retour de pression, navigation dans une liste, sélection de ligne | Uniquement quasi-imperceptible : en dessous de 150ms, ou rien |
| Occasionnel — feuilles, modales, toasts, étapes d'intégration | Animation standard |
| Rare / première fois — états de succès, illustrations d'état vide, célébration | Le budget du plaisir vit ici |
Les changements d'onglets ne glissent jamais. Les onglets sont des pairs, pas une hiérarchie — glisser implique une profondeur qui n'existe pas, et l'utilisateur le paie des dizaines de fois par session. animation: 'none'.
Si la demande échoue à cette porte, dites-le et ne l'écrivez pas.
2. Quel est le but ?
Nommez-le en un mot avant de continuer : feedback, cohérence spatiale, indication d'état, prévention d'un changement brusque, explication, ou plaisir (niveau rare uniquement).
Vous ne pouvez pas le nommer ? Ne le construisez pas.
3. Choisissez l'outil — le moins cher qui fonctionne
Descendez ; arrêtez-vous au premier qui correspond.
| Besoin | Outil |
|---|---|
| Un changement piloté par un état sans geste — pression, bascule, couleur, une valeur qui change | Transition CSS Reanimated (transitionProperty dans le style) |
| Boucle, multi-étape, ou se joue au montage sans changement d'état | Animation CSS Reanimated (animationName keyframes) |
| Un élément qui se monte ou se démonte, ou un réarrangement de liste | Layout animations (entering / exiting / itemLayoutAnimation) |
| Tout ce qu'un doigt touche, ou tout ce qui dérive du défilement | useSharedValue + Gesture + useAnimatedStyle |
| D'écran à écran | Options de pile natives dans Expo Router. Ne faites jamais cela à la main |
| Une feuille inférieure qui est son propre écran | presentation: 'formSheet' — c'est un vrai UISheetPresentationController, gratuit et correct |
| Barre d'onglets | NativeTabs (depuis expo-router/unstable-native-tabs) — la vraie barre d'onglets de la plateforme, ses comportements et transitions inclus |
| Menu contextuel, aperçu appuyer-maintenir | Link.Menu / Link.Preview (Expo Router, iOS uniquement) — menus natifs et aperçus, jamais reconstruits en JS |
| En-tête qui se réduit en un grand titre | headerLargeTitleEnabled sur la pile native (iOS uniquement ; headerLargeTitle est déprécié) — pas un worklet de défilement |
| Tirer pour rafraîchir | RefreshControl — ne faites à la main que s'il s'agit d'une interaction signature (voir la recette de seuil) |
| UI qui suit le clavier | react-native-keyboard-controller — la position réelle du clavier, image par image, sur le thread UI |
| Illustration vectorielle, célébration, état vide | Lottie — pour illustration uniquement, jamais pour l'état UI |
| Une scène animée immense, dessin libre | @shopify/react-native-skia — un canevas, quand la hiérarchie des vues elle-même est le goulot d'étranglement |
N'utilisez une valeur partagée que lorsque la valeur est continue ou interruptible. Une échelle de pression est une transition CSS ; un glissement est une valeur partagée. Utiliser un worklet pour une bascule à deux états est l'équivalent mobile d'installer une bibliothèque de mouvement pour un fondu.
Dépendances. Installez avec npx expo install <paquet> — cela résout la version qui correspond au SDK du projet, ce qu'un simple npm install ne fera pas :
| Besoin | Paquet |
|---|---|
| Animation | react-native-reanimated + react-native-worklets |
| Gestes | react-native-gesture-handler |
| Navigation, feuilles, onglets natifs, menus | expo-router |
| Haptiques | expo-haptics |
| UI qui suit le clavier | react-native-keyboard-controller (nécessite KeyboardProvider à la racine — voir la recette du clavier) |
| Illustration, célébration | lottie-react-native |
| Scènes animées très grandes, dessin personnalisé | @shopify/react-native-skia |
4. Choisissez les propriétés
transformetopacitysont gratuits. Tout le reste est un passage de layout.width,height,margin,padding,flex,top,left,gapré-exécutent Yoga à chaque image pour ce nœud et ses frères.- La seule exception : un élément positionné en absolu sans enfants — une pilule d'onglet, un remplissage de barre de progression. Il est hors du flux, donc rien d'autre ne se re-dispose, et animer
widthconserve le rayon de bordure quescaleXétalerait. - Jamais
scale(0). Commencez parscale(0.9–0.97)+opacity: 0. Rien dans le monde réel n'apparaît de rien. transformest un tableau et l'ordre compte —[{ translateY }, { scale }]met à l'échelle après avoir déplacé ; inversé, la translation est également mise à l'échelle. Gardez translate en premier sauf si vous voulez la multiplication.- Les ombres Android sont
elevation, et animer elevation re-rend l'ombre à chaque image. Animez plutôt l'opacité d'une couche pré-ombragée. - Ne jamais animer l'intensité de
BlurView. Sous Android, cela re-rend le flou à chaque image. Utilisez plutôt un fondu enchaîné de l'opacité d'unBlurViewstatique. - Les pourcentages fonctionnent dans
translateet sont relatifs à la propre taille de l'élément —translateY('100%')déplace une feuille de sa propre hauteur quel que soit son contenu.
5. Timing ou ressort
Si un doigt était impliqué, utilisez un ressort. Les ressorts transportent la vélocité à travers une interruption ; les courbes de timing redémarrent. Tout le reste utilise le timing.
Le ressort de Reanimated prend les deux paramètres de conception d'Apple directement — utilisez cette forme, pas masse/rigidité/amortissement :
| Interaction | Config |
|---|---|
| Stabilisation par défaut, pas de dépassement | { duration: 400, dampingRatio: 1 } |
| Repositionnement / retour en place après un glissement | { duration: 400, dampingRatio: 0.8, velocity } |
| Feuille, tiroir | { duration: 300, dampingRatio: 0.8, velocity } |
| Ne doit pas dépasser un bord dur | ajoutez overshootClamping: true |
Rebond seulement quand le geste avait de l'élan. Un dépassement sur un menu qui est apparu en fondu semble étrange ; un dépassement sur une carte que vous avez balayée semble correct.
Facilitation, pour tout ce qui n'a pas de doigt dessus :
| Situation | Facilitation |
|---|---|
| Entrée ou sortie | ease-out |
| Déplacement / transformation à l'écran | ease-in-out |
| Mouvement constant (progression, défilement) | linear |
| Par défaut | ease-out |
Jamais ease-in sur l'UI. Il commence lentement, retardant le moment exact que l'utilisateur regarde. Les fonctions intégrées de Reanimated sont aussi faibles que celles de CSS — utilisez celles-ci :
import { Easing } from 'react-native-reanimated';
const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1); // ease-out fort pour l'UI
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1); // mouvement à l'écran
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1); // courbe de feuille iOS
Durée :
| Élément | Durée |
|---|---|
| Retour de pression | 100–150ms |
| Bascule, chip, petit changement d'état | 150–200ms |
| Feuille, modale, tiroir | ressort, ~300ms perçues |
| Transition d'écran | la valeur par défaut de la plateforme — ne la remplacez pas |
Les animations UI mobiles restent sous 300ms, comme sur le web. Les propres transitions de la plateforme sont plus longues (la poussée iOS est de 350ms) ; suivez la plateforme pour la navigation, dépassez-la partout ailleurs.
6. Gardez-le en dehors du thread JS
C'est le savoir-faire spécifique au mobile, et c'est là que la plupart des mouvements React Native meurent.
- Jamais
setStatedepuis un gestionnaire de geste ou de défilement. Un rendu React par image est la cause numéro un de saccades dans les applications RN. Valeur partagée →useAnimatedStyle, et React ne re-rend jamais du tout. - Jamais de planification de retour vers le runtime RN à l'intérieur de
onUpdateou d'un gestionnaire de défilement.scheduleOnRN(fn, ...args)dereact-native-worklets— le remplacement Reanimated 4 du dépréciérunOnJS(fn)(...args)— met en file d'attente un appel du runtime RN, et dansonUpdatec'est 60–120× par seconde. Cela appartient àonEnd, ou à unuseAnimatedReactionqui se déclenche quand une valeur franchit un seuil. - Ne lisez jamais une valeur partagée pendant le rendu (
translateY.get()dans JSX). C'est un instantané qui ne se met jamais à jour et qui se désynchronise silencieusement. Ne l'écrivez jamais non plus pendant le rendu — cela se déclenche au milieu de la réconciliation, et un re-rendu que vous n'avez pas causé rejoue l'écriture. Touchez les valeurs partagées uniquement dans les worklets, les handlers et les effets. - Utilisez
.get()/.set(), pas.value. Même API, mais l'accès direct à.valueest la forme que le React Compiler ne peut pas voir — la documentation de Reanimated appelleget/setla manière sûre pour le compilateur.setprend également une mise à jour fonctionnelle :sv.set((v) => v + 1). - Les fonctions appelées depuis un worklet ont besoin de
'worklet'comme première ligne, sinon elles lèvent une erreur à l'exécution sur l'appareil alors qu'elles fonctionnent correctement dans le débogueur.
7. Pression, pas survol
Chaque affordance de survol du web doit être reconçue, pas portée.
- Feedback à l'enfoncement, validation au relâchement. Attendre la fin de l'appui avant de montrer quoi que ce soit semble mort — c'est la latence que l'utilisateur perçoit réellement.
scale: 0.97en 100–150ms sur tout élément pressable,Pressable+ une transition CSS.scaleemporte le label et les icônes avec lui, ce qui le rend physique.- Zone tactile minimale de 44×44pt (48dp Android). Si le visuel est plus petit, ajoutez
hitSlop— n'agrandissez pas le visuel. pressRetentionOffsetpour qu'un doigt dérivant de quelques pixels n'annule pas une pression que l'utilisateur voulait.- Ripple Android uniquement dans une application au style Material. Dans une application au design personnalisé, la même échelle sur les deux plateformes est plus cohérente qu'un ripple sur une seule.
8. Haptiques
Le mobile a un sens que le web n'a pas. Utilisez-le avec parcimonie et cela devient ce qui rend l'application chère ; utilisez-le partout et les utilisateurs le désactivent.
| Moment | Appel |
|---|---|
| Une valeur franchit un pas — sélecteur, cran de glissière, contrôle segmenté | Haptics.selectionAsync() |
| Quelque chose s'enclenche, un cran de feuille s'accroche, un glissement se valide | Haptics.impactAsync(ImpactFeedbackStyle.Light) |
| Un objet lourd atterrit, une action destructive se déclenche | Haptics.impactAsync(ImpactFeedbackStyle.Medium) |
| Opération réussie ou échouée | Haptics.notificationAsync(NotificationFeedbackType.Success / Error) |
Trois règles, et elles sont absolues :
- Même image que le visuel. Un haptique qui retarde son animation se lit comme un glitch, pas comme un feedback. Déclenchez-le au moment causal — l'accrochage du cran — pas quand l'animation se termine.
- Un par action utilisateur. Jamais sur le défilement, jamais par image, jamais sur une animation d'entrée que l'utilisateur n'a pas provoquée.
- Jamais le seul feedback. Les haptiques sont désactivés au niveau système pour de nombreux utilisateurs, et silencieux sur la plupart du matériel Android. Le visuel doit tenir seul.
Depuis un worklet, les haptiques doivent être planifiés vers le runtime RN : scheduleOnRN(Haptics.selectionAsync).
9. Mouvement réduit et accessibilité
import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';
const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);
// ou laissez chaque animation décider
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });
Mouvement réduit signifie moins et plus doux, pas zéro : gardez les changements d'opacité et de couleur qui expliquent un changement d'état, supprimez la translation, l'échelle, le parallaxe et le dépassement. Les transitions d'écran deviennent animation: 'fade'.
Échelles de texte. allowFontScaling est activé par défaut, donc toute hauteur que vous avez mesurée à la taille de police par défaut est erronée à 200%. Ne jamais animer vers une hauteur codée en dur — mesurez avec onLayout, ou animez plutôt une transformation.
Configuration qui casse silencieusement le mouvement
Vérifiez d'abord ces points quand « l'animation ne se lance tout simplement pas » :
- Installez via Expo pour que les versions correspondent au SDK :
npx expo install react-native-reanimated react-native-worklets. Dans un projet Expo,babel-preset-expoconfigure automatiquement le plugin Babel des worklets — pas d'étapebabel.config.js. Seulement un projet RN nu sans ce preset ajoute le plugin manuellement, et...