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épondre uniquement par :
Je suis prêt à créer des animations dans Expo et React Native qui se sentent naturelles sur un véritable appareil, mes connaissances viennent de la philosophie d'animation d'Emil Kowalski.
Ne fournissez aucune autre information tant que l'utilisateur n'a pas posé de 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 phare en mode développeur.
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 (hover). Chaque affordance que le web place dans le survol doit vivre dans l'appui, la position, ou rien.
- Il y a deux runtimes. Les Worklets (Reanimated 4) rendent cela explicite : le runtime React Native, où React fait le rendu et où votre logique applicative s'exécute, et le runtime UI, où les worklets s'exécutent à chaque frame (plus des runtimes worker 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 un raffinement – ils sont la 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 être animé. La grille ci-dessous existe pour produire zéro ligne de code parfois.
- Animer la bonne chose sur le mauvais thread – un
setStatepar frame, unPanResponder, uneheightanimée. Cela semble correct en développement sur votre téléphone mais tombe à 20fps sur un Android de trois ans.
Règles strictes
- Exécutez la séquence dans l'ordre. Les étapes 1 et 2 conditionnent tout.
- Reanimated, pas le
Animatedde base. LeAnimatedde base ne peut pas être piloté par un geste sans traverser le pont (bridge), etuseNativeDriverrefuse tout sauf transform et opacity. Les worklets de 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 (spring) proviennent des tableaux ci-dessous.
- La réduction de mouvement est livrée 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. Cette animation devrait-elle avoir lieu ?
| 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 les listes, sélection de ligne | Uniquement quasi-imperceptible : moins 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 de plaisir se trouve 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 condition, dites-le et ne l'écrivez pas.
2. Quel est le but ?
Nommez-le en un mot avant de continuer : feedback, consistance 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 coûteux qui fonctionne
Parcourez ; arrêtez-vous au premier qui correspond.
| Besoin | Outil |
|---|---|
| Un changement piloté par l'état sans geste – appui, bascule, couleur, une valeur qui change | Transition CSS Reanimated (transitionProperty dans le style) |
| Boucle, multi-étapes, ou joué au montage sans changement d'état | Animation CSS Reanimated (animationName keyframes) |
| Un élément qui se monte ou se démonte, ou un réordonnancement de liste | Animations de layout (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 jamais le faire à la main |
| Une feuille 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, avec ses comportements et transitions inclus |
| Menu contextuel, aperçu par appui long | 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 |
| Tirer pour rafraîchir | RefreshControl – à faire à la main uniquement lorsque c'est une interaction signature (voir la recette de seuil) |
| Interface qui suit le clavier | react-native-keyboard-controller – la position réelle du clavier, frame par frame, sur le thread UI |
| Illustration vectorielle, célébration, état vide | Lottie – pour illustration uniquement, jamais pour un état d'interface |
| Une scène animée énorme, dessin libre | @shopify/react-native-skia – un canvas, pour quand la hiérarchie de vues elle-même est le goulot d'étranglement |
N'utilisez une shared value que lorsque la valeur est continue ou interruptible. Une échelle d'appui est une transition CSS ; un glisser est une shared value. 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 fera pas :
| Besoin | Package |
|---|---|
| Animation | react-native-reanimated + react-native-worklets |
| Gestes | react-native-gesture-handler |
| Navigation, feuilles, onglets natifs, menus | expo-router |
| Haptiques | expo-haptics |
| Interface 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 layout.width,height,margin,padding,flex,top,left,gapréexécutent Yoga à chaque frame 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 relayout, et animer
widthconserve le rayon de bordure quescaleXétalerait. - Ne 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 réaffiche l'ombre à chaque frame. Animez plutôt l'opacité d'un calque pré-ombragé. - Ne jamais animer l'intensité de
BlurView. Sur Android, cela réaffiche le flou à chaque frame. Faites 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. Temporisation ou ressort
Si un doigt était impliqué, utilisez un ressort. Les ressorts transportent la vélocité à travers une interruption ; les courbes de temporisation redémarrent. Tout le reste utilise la temporisation.
Le ressort de Reanimated prend directement les deux paramètres de conception d'Apple – utilisez ce formulaire, pas mass/stiffness/damping :
| Interaction | Configuration |
|---|---|
| Stabilisation par défaut, sans dépassement | { duration: 400, dampingRatio: 1 } |
| Repositionnement / retour après un glisser | { 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 portait une impulsion. Un dépassement sur un menu qui est apparu en fondu semble incorrect ; un dépassement sur une carte que vous avez balancée semble correct.
Assouplissement, pour tout ce qui n'a pas de doigt dessus :
| Situation | Assouplissement |
|---|---|
| Entrée ou sortie | ease-out |
| Déplacement / transformation à l'écran | ease-in-out |
| Mouvement constant (progression, marquee) | linear |
| Par défaut | ease-out |
Ne jamais ease-in sur l'interface. 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); // fort ease-out pour l'interface
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çue |
| Transition d'écran | la valeur par défaut de la plateforme – ne la remplacez pas |
Les animations d'interface mobile restent sous 300ms, comme sur le web. Les transitions de la plateforme elle-même sont plus longues (le push iOS est de 350ms) ; suivez la plateforme pour la navigation, battez-la partout ailleurs.
6. Gardez-la 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.
- Ne jamais
setStatedepuis un gestionnaire de geste ou de défilement. Un rendu React par frame est la cause numéro un de saccades dans les applications RN. Shared value →useAnimatedStyle, et React ne fait jamais de nouveau rendu du tout. - Ne jamais planifier 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 Reanimated 4 de l'obsolèterunOnJS(fn)(...args)– met en file d'attente un appel au 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 jamais lire une shared value pendant le rendu (
translateY.get()dans JSX). C'est un instantané qui ne se met jamais à jour et qui se désynchronise silencieusement. Ne jamais en écrire non plus pendant le rendu – cela se déclenche en pleine réconciliation, et un nouveau rendu que vous n'avez pas causé rejoue l'écriture. Touchez les shared values 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écurisée pour le compilateur.setaccepte é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. Appui, pas survol
Chaque affordance de survol du web doit être repensée, pas portée.
- Retour au moment de l'appui, validation au relâchement. Attendre que le tap soit terminé avant de montrer quoi que ce soit donne une impression de 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 elle le label et les icônes, ce qui la rend physique.- Cible 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 un appui 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. Haptiques
Le mobile a un sens que le web n'a pas. Utilisez-le avec parcimonie et il devient ce qui rend l'application chère ; utilisez-le partout et les utilisateurs le désactivent.
| Moment | Appel |
|---|---|
| Une valeur dépasse un cran – sélecteur, détente de glissière, contrôle segmenté | Haptics.selectionAsync() |
| Quelque chose s'enclenche, une détente de feuille attrape, un glisser s'engage | 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 frame que le visuel. Un haptique qui retarde son animation est perçu comme un bug, pas comme un retour. Déclenchez-le au moment causal – la détente qui attrape – pas lorsque l'animation se termine.
- Un par action utilisateur. Jamais sur le défilement, jamais par frame, jamais sur une animation d'entrée que l'utilisateur n'a pas causée.
- Jamais le seul retour. Les haptiques sont désactivés à l'échelle du système pour de nombreux utilisateurs, et silencieux sur la plupart des matériels Android. Le visuel doit se suffire à lui-même.
Depuis un worklet, les haptiques doivent être programmés pour revenir au runtime RN : scheduleOnRN(Haptics.selectionAsync).
9. Réduction de mouvement 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 });
Réduction de mouvement 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 mesurée à la taille de police par défaut est fausse à 200%. Ne faites jamais d'animation 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 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 automatiquement le plugin Babel des worklets – pas d'étapebabel.config.js. Seul un projet RN nu sans ce preset ajoute le plugin manuellement.
...
[Le contenu original est tronqué pour la traduction]