Communitygithub.com

Conception d'animations dans Expo et React Native

Crée des animations dans React Native et Expo, en prenant les décisions dans l'ordre qui détermine si elles semblent naturelles – doit-elle animer, sur quel thread, quelles propriétés, ressort ou temporisation, comment le geste passe la main, comment elle se dégrade. Rédige l'implémentation avec Reanimated, Gesture Handler, Expo Router et expo-haptics. Utiliser pour animer quoi que ce soit dans une application Expo, ajouter des gestes, des feuilles, des transitions d'écran, des retours de pression ou des vibrations, ou corriger des mouvements qui saccadent sur l'appareil.

Qu'est-ce que Conception d'animations dans Expo et React Native ?

Cette compétence est conçue pour les développeurs construisant des animations mobiles performantes et naturelles dans des applications Expo et React Native, en s'appuyant sur la philosophie d'Emil Kowalski. Elle couvre l'ensemble du processus de création d'animations, depuis la décision initiale de savoir si une animation est nécessaire jusqu'à l'implémentation finale, en passant par le choix des propriétés, des outils (comme Reanimated 4 pour les animations sur le thread UI), des gestes (Gesture Handler) et des techniques de retour haptique (expo-haptics). La compétence met l'accent sur des règles strictes : ne jamais animer sur le mauvais thread (JS vs UI), éviter les valeurs approximées, tester sur une version de release sur l'appareil le plus lent, et intégrer la réduction de mouvement dès le départ. Elle fournit des tableaux de décision pour évaluer la fréquence d'une animation, choisir l'outil approprié (comme les transitions CSS de Reanimated, les animations de layout, ou les shared values), et configurer les ressorts (springs) et les courbes d'assouplissement (easing) avec des paramètres précis. Les plateformes principales sont Expo et React Native, avec des packages comme react-native-reanimated, react-native-gesture-handler, expo-router, expo-haptics, react-native-keyboard-controller, lottie-react-native et @shopify/react-native-skia. La compétence insiste sur le fait que les animations mobiles diffèrent du web en raison de l'absence de survol (hover), de la présence de deux runtimes (JS et UI), et du toucher direct de l'utilisateur. Elle rejette les animations inutiles (comme les slides entre onglets) et privilégie les solutions natives (comme les tabs natives, les feuilles système, ou les RefreshControl).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 :

  1. 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.
  2. 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.
  3. 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 :

  1. Animer quelque chose qui ne devrait pas être animé. La grille ci-dessous existe pour produire zéro ligne de code parfois.
  2. Animer la bonne chose sur le mauvais thread – un setState par frame, un PanResponder, une height animée. Cela semble correct en développement sur votre téléphone mais tombe à 20fps sur un Android de trois ans.

Règles strictes

  1. Exécutez la séquence dans l'ordre. Les étapes 1 et 2 conditionnent tout.
  2. Reanimated, pas le Animated de base. Le Animated de base ne peut pas être piloté par un geste sans traverser le pont (bridge), et useNativeDriver refuse 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é.
  3. Pas de valeurs approximées. Les courbes et les configurations de ressort (spring) proviennent des tableaux ci-dessous.
  4. La réduction de mouvement est livrée avec l'animation, pas comme un suivi.
  5. 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équenceDécision
100+ fois/jour – changements d'onglets, ouverture/fermeture du clavier, défilement, bascules dans les paramètresPas 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 ligneUniquement quasi-imperceptible : moins de 150ms, ou rien
Occasionnel – feuilles, modales, toasts, étapes d'intégrationAnimation standard
Rare / première fois – états de succès, illustrations d'état vide, célébrationLe 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.

BesoinOutil
Un changement piloté par l'état sans geste – appui, bascule, couleur, une valeur qui changeTransition CSS Reanimated (transitionProperty dans le style)
Boucle, multi-étapes, ou joué au montage sans changement d'étatAnimation CSS Reanimated (animationName keyframes)
Un élément qui se monte ou se démonte, ou un réordonnancement de listeAnimations de layout (entering / exiting / itemLayoutAnimation)
Tout ce qu'un doigt touche, ou tout ce qui dérive du défilementuseSharedValue + Gesture + useAnimatedStyle
D'écran à écranOptions de pile native dans Expo Router. Ne jamais le faire à la main
Une feuille qui est son propre écranpresentation: 'formSheet' – c'est un vrai UISheetPresentationController, gratuit et correct
Barre d'ongletsNativeTabs (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 longLink.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 titreheaderLargeTitleEnabled sur la pile native (iOS uniquement ; headerLargeTitle est obsolète) – pas un worklet de défilement
Tirer pour rafraîchirRefreshControl – à faire à la main uniquement lorsque c'est une interaction signature (voir la recette de seuil)
Interface qui suit le clavierreact-native-keyboard-controller – la position réelle du clavier, frame par frame, sur le thread UI
Illustration vectorielle, célébration, état videLottie – 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 :

BesoinPackage
Animationreact-native-reanimated + react-native-worklets
Gestesreact-native-gesture-handler
Navigation, feuilles, onglets natifs, menusexpo-router
Haptiquesexpo-haptics
Interface suivant le clavierreact-native-keyboard-controller (nécessite KeyboardProvider à la racine – voir la recette du clavier)
Illustration, célébrationlottie-react-native
Très grandes scènes animées, dessin personnalisé@shopify/react-native-skia

4. Choisissez les propriétés

  • transform et opacity sont gratuits. Tout le reste est un passage de layout. width, height, margin, padding, flex, top, left, gap ré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 width conserve le rayon de bordure que scaleX étalerait.
  • Ne jamais scale(0). Commencez par scale(0.9–0.97) + opacity: 0. Rien dans le monde réel n'apparaît de rien.
  • transform est 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'un BlurView statique.
  • Les pourcentages fonctionnent dans translate et 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 :

InteractionConfiguration
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 stricteajoutez 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 :

SituationAssouplissement
Entrée ou sortieease-out
Déplacement / transformation à l'écranease-in-out
Mouvement constant (progression, marquee)linear
Par défautease-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émentDurée
Retour de pression100–150ms
Bascule, chip, petit changement d'état150–200ms
Feuille, modale, tiroirressort, ~300ms perçue
Transition d'écranla 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 setState depuis 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 onUpdate ou d'un gestionnaire de défilement. scheduleOnRN(fn, ...args) de react-native-worklets – le remplacement Reanimated 4 de l'obsolète runOnJS(fn)(...args) – met en file d'attente un appel au runtime RN, et dans onUpdate, c'est 60 à 120 fois par seconde. Il appartient à onEnd, ou dans un useAnimatedReaction qui 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 à .value est la forme que le React Compiler ne peut pas voir – la documentation de Reanimated appelle get/set la manière sécurisée pour le compilateur. set accepte é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.97 en 100–150ms sur tout élément pressable, Pressable + une transition CSS. scale emporte 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.
  • pressRetentionOffset pour 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.

MomentAppel
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'engageHaptics.impactAsync(ImpactFeedbackStyle.Light)
Un objet lourd atterrit, une action destructive se déclencheHaptics.impactAsync(ImpactFeedbackStyle.Medium)
Opération réussie ou échouéeHaptics.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-expo configure automatiquement le plugin Babel des worklets – pas d'étape babel.config.js. Seul un projet RN nu sans ce preset ajoute le plugin manuellement.

...

[Le contenu original est tronqué pour la traduction]

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.

Skills associés