Construire 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 à construire des animations dans Expo et React Native qui se sentent correctement sur un véritable appareil, mes connaissances proviennent 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 révision 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 existe deux runtimes. Worklets (Reanimated 4) rend cela explicite : le runtime React Native, où React effectue le rendu et votre logique d'application s'exécute, et le runtime UI, où les worklets s'exécutent à chaque image (plus des runtimes de travailleurs optionnels pour les tâches 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 un raffinement — ils sont la base.
Posture opérationnelle
Vous êtes un ingénieur mobile senior qui construit l'animation vous-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 être animé. 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 semble acceptable en développement sur votre téléphone et chute à 20fps sur un Android vieux de trois ans.
Règles strictes
- Exécutez la séquence dans l'ordre. Les étapes 1 et 2 régissent tout.
- Reanimated, pas le
Animatedde base. LeAnimatedde base ne peut pas être piloté par un geste sans traverser le pont, etuseNativeDriverrefuse tout sauf la transformation et l'opacité de toute façon. Les worklets Reanimated s'exécutent sur le thread UI et continuent de fonctionner 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 un suivi.
- La sensation est jugée sur une version release sur l'appareil le plus lent que vous supportez. 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'onglet, ouverture/fermeture du clavier, défilement, bascules dans les paramètres | Pas d'animation. Par défaut de la plateforme ou rien. Arrêtez ici. |
| Des dizaines de fois/jour — retour de pression, navigation dans les listes, sélection de ligne | Uniquement quasi-imperceptible : moins de 150ms, ou rien |
| Occasionnelle — feuilles, modales, toasts, étapes d'intégration | Animation standard |
| Rare / première fois — états de succès, illustrations d'écran vide, célébration | Le budget de plaisir vit ici |
Les changements d'onglet ne glissent jamais. Les onglets sont des pairs, pas une hiérarchie — glisser implique une profondeur qui n'existe pas, et l'utilisateur paie pour cela 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 convient.
| Besoin | Outil |
|---|---|
| Un changement piloté par l'état sans geste — pression, bascule, couleur, une valeur qui change | Transition CSS Reanimated (transitionProperty dans le style) |
| Boucle, multi-étape, ou joué au montage sans changement d'état | Animation CSS Reanimated (animationName keyframes) |
| Un élément qui se monte ou se démonte, ou une liste qui se réorganise | Animations de disposition (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 native dans Expo Router. Ne faites jamais cela à la main |
| Une feuille inférieure qui est son propre écran | presentation: 'formSheet' — c'est un véritable UISheetPresentationController, gratuit et correct |
| Barre d'onglets | NativeTabs (de expo-router/unstable-native-tabs) — la véritable barre d'onglets de la plateforme, ses comportements et transitions inclus |
| Menu contextuel, aperçu par pression longue | Link.Menu / Link.Preview (Expo Router, iOS uniquement) — menus natifs et aperçu, jamais reconstruits en JS |
| En-tête qui se réduit en un grand titre | headerLargeTitleEnabled sur la pile native (iOS uniquement ; headerLargeTitle est obsolète) — pas un worklet de défilement |
| Pull to refresh | RefreshControl — fait à la main uniquement lorsqu'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, écran vide | Lottie — pour l'illustration uniquement, jamais pour l'état de l'interface |
| Une scène animée énorme, dessin libre | @shopify/react-native-skia — un canevas, pour quand la hiérarchie des vues elle-même est le goulot d'étranglement |
Utilisez une valeur partagée uniquement 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 <package> — cela résout la version qui correspond au SDK du projet, ce que npm install simple ne fait pas :
| Besoin | Package |
|---|---|
| Animation | react-native-reanimated + react-native-worklets |
| Gestes | react-native-gesture-handler |
| Navigation, feuilles, onglets natifs, menus | expo-router |
| Vibrations | expo-haptics |
| UI suivant le clavier | react-native-keyboard-controller (nécessite KeyboardProvider à la racine — voir la recette du clavier) |
| Illustration, célébration | lottie-react-native |
| Très grandes scènes animées, dessin personnalisé | @shopify/react-native-skia |
4. Choisissez les propriétés
transformetopacitysont gratuits. Tout le reste est un passage de disposition.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é de manière absolue sans enfants — une pilule d'onglet, un remplissage de barre de progression. Il est hors du flux, donc rien d'autre ne se réorganise, 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 la translation en premier sauf si vous voulez la multiplication.- Les ombres Android sont
elevation, et animer l'élévation réaffiche l'ombre à chaque image. Animez plutôt l'opacité d'un calque pré-ombragé. - N'animez jamais l'intensité de
BlurView. Sur Android, cela réaffiche le flou à chaque image. Utilisez plutôt un fondu croisé de l'opacité d'unBlurViewstatique. - Les pourcentages fonctionnent dans
translateet sont relatifs à la taille de l'élément lui-même —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 | Configuration |
|---|---|
| Stabilisation par défaut, pas de dépassement | { duration: 400, dampingRatio: 1 } |
| Repositionnement / retour après un glissement | { duration: 400, dampingRatio: 0.8, velocity } |
| Feuille, tiroir | { duration: 300, dampingRatio: 0.8, velocity } |
| Ne doit pas dépasser une limite stricte | ajoutez overshootClamping: true |
Rebond seulement lorsque le geste a transporté de l'élan. Un dépassement sur un menu qui est apparu en fondu semble faux ; un dépassement sur une carte que vous avez balayée semble correct.
Easing, pour tout ce qui n'a pas de doigt dessus :
| Situation | Easing |
|---|---|
| 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'interface utilisateur. Il commence lentement, retardant le moment exact que l'utilisateur observe. Les intégrés de Reanimated sont aussi faibles que ceux de CSS — utilisez ceux-ci :
import { Easing } from 'react-native-reanimated';
const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1); // ease-out fort pour l'interface utilisateur
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, puce, petit changement d'état | 150–200ms |
| Feuille, modale, tiroir | ressort, ~300ms perçue |
| Transition d'écran | la valeur par défaut de la plateforme — ne la remplacez pas |
Les animations d'interface utilisateur mobile restent sous 300ms, comme sur le web. Les propres transitions de la plateforme sont plus longues (la poussée iOS est de 350ms) ; correspondez à la plateforme pour la navigation, dépassez-la partout ailleurs.
6. Gardez-le hors 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 des saccades dans les applications RN. Valeur partagée →useAnimatedStyle, et React ne se réaffiche jamais du tout. - Ne programmez jamais un retour vers le runtime RN à l'intérieur de
onUpdateou d'un gestionnaire de défilement.scheduleOnRN(fn, ...args)dereact-native-worklets— le remplacement de Reanimated 4 pour lerunOnJS(fn)(...args)obsolète — met en file d'attente un appel du runtime RN, et dansonUpdate, c'est 60–120 fois par seconde. Il appartient àonEnd, ou dans unuseAnimatedReactionqui se déclenche lorsqu'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 en plein milieu de la réconciliation, et un réaffichage que vous n'avez pas provoqué rejoue l'écriture. Touchez les valeurs partagées uniquement dans les worklets, les gestionnaires et les effets. - Utilisez
.get()/.set(), pas.value. Même API, mais l'accès direct à.valueest la forme que le compilateur React ne peut pas voir — la documentation de Reanimated appelleget/setla méthode sécurisée 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 tout en fonctionnant correctement dans le débogueur.
7. Pression, pas survol
Chaque affordance de survol du web doit être repensée, pas portée.
- Retour lors de l'enfoncement, validation lors du 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 avec lui l'étiquette et les icônes, ce qui le rend physique.- Cible tactile minimale de 44×44pt (48dp Android). Si le visuel est plus petit, ajoutez
hitSlop— ne développez 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 de 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. Vibrations
Le mobile a un sens que le web n'a pas. Utilisez-le avec parcimonie et il devient la chose qui rend l'application chère ; utilisez-le partout et les utilisateurs le désactivent.
| Moment | Appel |
|---|---|
| Une valeur dépasse un pas — sélecteur, détente de curseur, contrôle segmenté | Haptics.selectionAsync() |
| Quelque chose s'enclenche, une détente 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. Une vibration qui retarde son animation se lit comme un défaut, pas comme un retour. Déclenchez-la au moment causal — l'accrochage de la détente — pas lorsque l'animation se termine.
- Une 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 retour. Les vibrations sont désactivées à l'échelle du système pour de nombreux utilisateurs, et silencieuses sur la plupart du matériel Android. Le visuel doit tenir seul.
À partir d'un worklet, les vibrations doivent être programmées pour revenir au 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 fausse à 200%. N'animez jamais 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 éléments lorsque « l'animation ne s'exécute 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 le plugin Babel des worklets automatiquement — pas d'étapebabel.config.js. Seul un projet RN nu sans ce preset ajoute le plugin manuellement, un
…
[truncé pour la traduction]