Que fait Flutter Motion UI ?
Cette compétence produit des écrans Flutter qui semblent être un produit cohérent et fini à la main : chaque élément arrive avec une intention, chaque pression répond, chaque changement d'état est visible et les données restent cohérentes entre les écrans.
Elle a été distillée à partir d'une analyse image par image de 22 enregistrements d'applications de référence (portefeuille, livraison, covoiturage, fitness, auth/OTP, alarme, checkout, réservation, appairage d'appareils). references/video-analysis.md répertorie ce que fait chacune et quelle recette la reproduit.
L'idée centrale : l'état pilote le mouvement
Presque tous les moments « fluides » dans les références utilisent le même mécanisme : un changement d'état a eu lieu, et l'UI a animé de l'ancienne valeur à la nouvelle. Personne n'a appelé controller.forward() depuis un gestionnaire de bouton. Donc le travail consiste toujours à :
- Modéliser les états de l'écran explicitement (une classe scellée, pas cinq booléens).
- Rendre avec un
switchsur cet état. - Envelopper ce qui change dans une animation implicite (
AnimatedSwitcher,AnimatedContainer,TweenAnimationBuilder, ou un widget du kit) pour que la différence entre deux états s'anime d'elle-même.
Lorsque cela est fait, l'animation et la gestion d'état cessent d'être deux problèmes. Les animations interrompues, les doubles pressions et les bugs « spinner de chargement à côté du tick de succès » disparaissent car les états impossibles ne peuvent pas être représentés.
Les AnimationController explicites sont réservés à trois choses : les gestes pilotés par les doigts, les ambiances en boucle (pulsations, scanners) et les séquences chorégraphiées en plusieurs parties.
Flux de travail
1. Lire le projet avant d'écrire quoi que ce soit
pubspec.yaml: SDK Flutter/Dart, bibliothèque d'état déjà utilisée (riverpod / bloc / provider / getx / aucun), routeur (go_router / auto_route / Navigator), packages d'animation existants.- Thème, couleurs, espacement, widgets partagés existants. Étendez ce qui existe ; n'introduisez pas un deuxième système de conception ou une deuxième bibliothèque d'état. Respectez la structure des dossiers et la dénomination du projet. Dans une application existante, gardez les modifications apportées aux fichiers que vous n'avez pas été invité à modifier aussi petites que nécessaire pour la fonctionnalité (un wrapper
Hero, un remplissage), laissez les corrections de lint ou de style non liées tranquilles à moins qu'on ne vous le demande, et listez chaque fichier existant que vous avez réécrit dans votre résumé pour que le diff ne contienne pas de surprises. - S'il s'agit d'un nouveau projet ou s'il n'a pas de conventions, utilisez les valeurs par défaut de cette compétence (Riverpod
Notifier, thème Material 3 avec extensions,lib/core/+lib/features/<name>/).
2. Installer le kit de mouvement une fois
Copiez les fichiers du kit dont la tâche a besoin dans le dossier d'UI partagée du projet (par défaut lib/core/motion/) : toujours motion.dart, plus seulement les widgets que vous allez réellement utiliser, et adaptez le fichier barrel pour correspondre. Copier les dix fichiers pour un écran qui en utilise trois laisse à l'utilisateur du code que personne n'appelle. Le kit est du Flutter pur sans dépendances, propre pour l'analyseur et testé avec des widgets. Si le projet a déjà un équivalent (son propre fichier de durées, sa propre barre de navigation), adaptez-vous au leur au lieu de dupliquer.
| Fichier | Vous donne |
|---|---|
motion.dart | Motion.fast/base/slow/page/hero, courbes, ressorts, aide pour mouvement réduit – le seul endroit où vivent les durées ; Haptics.tap/selection/success/error – le seul endroit où les haptiques sont déclenchés |
entrance.dart | Entrance (fondu/glissement/flou échelonné), StateSwitcher (switch animé sur l'état) |
page_routes.dart | AppRoute, AppPageTransitions.theme(), showAppSheet, heroFadeShuttle |
glass_nav_bar.dart | GlassNavBar barre pilote flottante en verre liquide avec indicateur de lentille coulissant |
morph_button.dart | Pressable, MorphButton (inactif→spinner→succès), AsyncMorphButton |
slide_to_confirm.dart | SlideToConfirm glisser pour valider avec haptiques et statut |
rolling_number.dart | CountUpText, RollingText (chiffres de compteur) |
otp_boxes.dart | OtpBoxes, Shake |
animated_items.dart | AnimatedItems<T> – liste qui anime les insertions/suppressions à partir d'une liste immuable simple |
assets/examples/send_money_flow.dart est un flux complet travaillé (liste → clavier → glisser → envoi → succès → retour, une nouvelle ligne s'anime). Lisez-le lors de la construction d'un flux multi-états ; c'est le modèle à imiter. send_money_flow_test.dart à côté montre comment tester un tel flux (chemin complet, débordement sur petit écran, mouvement réduit).
assets/project_setup/analysis_options.yaml est l'ensemble strict de lint que le kit réussit. Proposez de le fusionner dans la configuration de l'analyseur du projet ; n'écrasez pas les règles qu'une équipe a déjà choisies.
3. Concevoir l'écran comme des états et des moments, puis construire
Avant de coder un écran, notez (dans votre tête ou un court commentaire) :
- États : quelles sont les choses distinctes que cet écran peut être ? (par exemple
Editing → Submitting → Done | Failed) - Données partagées : qu'est-ce que cet écran montre qu'un autre écran montre aussi ? Ces données obtiennent un propriétaire.
- Moments : entrée, l'action principale, chaque changement d'état et sortie. Chacun obtient un mouvement délibéré du tableau ci-dessous. Tout le reste reste immobile.
Ensuite, construisez dans cet ordre : jetons/thème → mise en page statique → couche d'état → animations de changement d'état → échelonnement de l'entrée → transition de navigation → haptiques → vérification du mouvement réduit et du petit écran.
4. Vérifier
Exécutez dart format sur les fichiers que vous avez touchés et flutter analyze jusqu'à ce que ce soit propre. Lorsqu'un appareil/émulateur est disponible, exécutez l'application et regardez réellement le flux ; sinon, écrivez un court test de widget qui parcourt les états (voir la forme du test d'exemple) et exécutez-le. Ensuite, parcourez references/consistency-checklist.md.
Quel mouvement pour quel moment
| Moment | Utilisation | Timing |
|---|---|---|
| L'écran apparaît pour la première fois | Entrance(index: n) sur 3 à 7 blocs de niveau supérieur, de haut en bas | slow, 55 ms d'écart |
| Pousser vers un écran non lié (splash→accueil, auth→app) | AppTransition.fadeThrough | page |
| Prochaine étape dans le même flux (téléphone→OTP→mot de passe) | AppTransition.sharedAxisX + indicateur d'étape animé | page |
| Élément de liste → son détail | Hero sur l'image/carte + le reste du détail fondu après | hero |
| Confirmer / choisir / évaluer / sélectionner | showAppSheet, contenu échelonné à l'intérieur | page |
| Requête en cours | MorphButton ou SlideToConfirm avec status | base par phase |
| Changement de valeur (prix, ETA, solde) | RollingText (discret) / CountUpText (magnitude) | base / long |
| Élément ajouté / supprimé | AnimatedItems | base |
| Changement d'état de l'écran (chargement→contenu→erreur) | StateSwitcher | base |
| Sélection (chip, carte, onglet, étoile) | AnimatedContainer couleur/bordure + petit AnimatedScale | fast |
| Toute pression | Pressable échelle + léger haptique | instant |
| Échec de validation | Shake + bordure rouge + message ; conservez l'entrée | slow |
| Succès | la coche apparaît avec Motion.overshoot, maintenez successHold, puis passez à autre chose | — |
Règles empiriques pour rester de bon goût :
- Les entrées ne se jouent qu'une fois. Dans les listes paresseuses, une ligne qui défile de nouveau dans la vue est reconstruite et s'animerait à nouveau ; passez
Entrance(enabled: …)pour que seule la première apparition s'anime. - Un élément phare par navigation. Un Hero ou un fondu traversant ou un grand échelonnement – pas les trois.
- Entrez lentement, sortez vite. Les sorties s'exécutent à ~60–80% de la durée d'entrée avec
Motion.exit. - Les choses qui sont liées bougent ensemble ; les choses non liées sont échelonnées.
- Animez la transformation et l'opacité ; évitez d'animer la mise en page dans les longues listes. Le flou est coûteux – utilisez-le sur quelques éléments Hero, jamais par ligne de liste.
- Ne bloquez jamais l'entrée pour la décoration. Les entrées ne doivent pas retarder la tapabilité ; seul un vrai travail (réseau) désactive les contrôles.
- Respectez le mouvement réduit : le kit réduit déjà les durées via
Motion.of(context, …); faites de même dans tout contrôleur que vous écrivez.
Essentiels de la gestion d'état
Guide complet avec les équivalents Riverpod / Bloc / ChangeNotifier : references/state.md. Les non-négociables :
- L'état du flux est une classe scellée ; l'UI est un
switchexhaustif. Transportez les données dont chaque état a besoin à l'intérieur. - Un propriétaire par élément de données partagées. Un écran de liste et un écran de détail/flux lisent le même fournisseur ; le flux écrit dedans. Ne transmettez pas les résultats via
Navigator.popet ne corrigez pas une copie locale – c'est ainsi que les écrans se désynchronisent. - Conservez l'entrée de l'utilisateur en cas d'échec. Un envoi échoué revient à l'état d'édition avec les champs intacts plus une erreur.
- Effets secondaires dans les écouteurs, pas dans
build. La navigation, les snackbars, les haptiques réagissent aux transitions d'état (ref.listen,BlocListener). - L'état d'animation reste dans les widgets ; l'état métier jamais. Un contrôleur connaît
Submitting; il ne connaît pas lesAnimationController. - Les données en direct sont un flux mappé en état (ETA, position du conducteur, statut de la commande), avec le widget interpolant entre les ticks pour que le mouvement soit continu même lorsque les mises à jour arrivent une fois par seconde.
- Protégez les écarts asynchrones (
ref.mounted/isClosed/mounted) avant de toucher à l'état après unawait.
Cohérence de l'UI
La cohérence est ce qui distingue une application conçue d'un tas de beaux écrans. Mettez les jetons dans le thème et ne les codez jamais en dur dans les widgets :
- Couleur :
ColorScheme+ uneThemeExtensionpour les extras de marque (succès, teinte de verre, dégradés). Les widgets lisentTheme.of(context); c'est aussi ce qui rend le changement animé clair/sombre gratuit. - Espacement : une échelle de 4 points (4, 8, 12, 16, 20, 24, 32). Un remplissage de page horizontal pour toute l'application.
- Rayon : trois valeurs (par exemple 12 petit / 20 carte / 28 feuille) plus pilule. Même carte = même rayon partout.
- Typographie : rôles
TextThemeuniquement ; chiffres tabulaires pour tout nombre qui change. - Mouvement :
Motion.*uniquement. - Composants : un bouton principal, un style de feuille, un style d'entrée, une barre de navigation. Si une deuxième variante apparaît, promouvez-la en widget partagé avec un paramètre.
Détails et liste d'audit : references/consistency-checklist.md.
Barre de qualité du code
L'UI animée multiplie le coût d'un code bâclé : une méthode build qui s'exécute 120 fois par seconde, un contrôleur qui survit à son écran, une mise en page qui ne tient que sur un téléphone. Tenez chaque fichier à la même barre que le kit. references/flutter-best-practices.md contient les conseils complets ; les points qui échouent le plus souvent :
- Petites classes de widget, pas de méthodes d'aide
_buildX(), avec des constructeursconst– pour qu'une reconstruction ne touche que ce qui a changé. - Tout ce qui est créé est disposé : contrôleurs d'animation/texte/défilement/page,
CurvedAnimation, nœuds de focus, minuteries, abonnements. - Protégez chaque écart asynchrone (
context.mounted/ref.mounted/isClosed) et ne laissez jamais tomber un Future en silence (awaitouunawaited). - Clés stables :
ValueKey(item.id)dans les listes dynamiques et sur les enfantsAnimatedSwitcher; jamais de clés d'index, jamais de clés créées dansbuild. - Mises en page qui défilent au lieu de déborder : tout écran avec un clavier, un formulaire ou un sélecteur doit survivre à une fenêtre d'affichage de 320×480, un clavier ouvert et un texte 1,3×.
- Chaque écran survit à une fenêtre étroite + un grand texte, pas seulement le flux que l'on vous a demandé : à 320 de large avec un texte 1,6×, un
Rowcontenant un titre et un montant, une carte avec un nombre et une étiquette, ou une vignette de liste débordera latéralement à moins que le texte ne soit dansExpanded/FlexibleavecmaxLinesetoverflow. Incluez un test qui pompe le premier écran de l'application (et chaque onglet) à 320×568 avectester.platformDispatcher.textScaleFactorTestValue = 1.6et n'attend aucune exception. - Testez le geste malheureux : un glissement relâché tôt, une deuxième pression pendant le chargement, retour arrière appuyé en milieu de requête. Ces chemins contiennent les plantages qu'un test de bout en bout ne touche jamais.
- Pas de littéraux dans le code des fonctionnalités : couleurs, rayons, espacement, durées, haptiques proviennent tous du thème/jetons/
Motion/Haptics; les chaînes destinées à l'utilisateur suivent la configuration de localisation du projet. - Listes paresseuses et reconstructions limitées : builders pour tout ce qui est défilable,
selectpour les valeurs qui changent, sous-arbres statiques passés commechild. - Accessible par construction : sémantique sur les contrôles personnalisés, une alternative pour les actions basées uniquement sur les gestes, mouvement réduit respecté. Un wrapper
Semantics(label: …, excludeSemantics: true)supprime également l'action de pression de l'enfant – passezonTapauSemanticségalement. - Testé là où ça compte : transitions d'état du contrôleur comme tests unitaires ; un test de widget par flux affirmant les résultats, pas les détails internes de l'animation.
Fichiers de référence – lisez celui qui correspond à la tâche
references/motion-system.md— jetons expliqués, chorégraphie et recettes pour des effets non présents dans le kit (séquences splash, mise au point floue, anneaux de progression, lignes de scanner, interpolations de couleur/thème, en-têtes liés au défilement).references/navigation-transitions.md— transitions de page, Hero correctement fait, container-transform, feuilles inférieures, flux multi-étapes, intégration go_router.references/glass-nav-bar.md— comment la barre en verre liquide est construite, réglage, performance, état du shell/onglet, pièges connus.references/state.md— états de flux, état partagé, modèles asynchrones/optimistes, flux en direct, dans Riverpod, Bloc et ChangeNotifier.references/components.md— recettes : progression par étapes, cartes/chips sélectionnables, évaluation par étoiles avec étiquette réactive, carrousel de cartes qui re-teinte la page, sélecteurs à roue, squelettes, feuille de suivi en direct + marqueur d'itinéraire, barre d'état mini persistante.references/video-analysis.md— les 22 enregistrements analysés : ce qui se passe à l'écran et comment le reconstruire.references/flutter-best-practices.md— structure du projet, composition des widgets, cycle de vie, sécurité asynchrone, habitudes Dart 3, mise en page robuste, performance, thématisation, l10n/accessibilité, états d'erreur, tests, outils. Lisez avant de créer une nouvelle structure de projet ou lors de la révision/refactorisation de code existant.references/consistency-checklist.md— jetons, QA avant livraison, vérifications de performance et d'accessibilité.
Attentes de sortie
- Livrez des fichiers complets et exécutables dans la structure du projet – pas des fragments avec «…le reste de votre code ».
- Utilisez les packages existants du projet. Suggérez un nouveau package uniquement lorsqu'il gagne clairement sa place, et dites pourquoi.
- Les API Flutter évoluent rapidement. Si le SDK installé est plus récent que ce dont vous êtes sûr, vérifiez la signature (
flutter analyzeest l'oracle le plus rapide) plutôt que de deviner. - En terminant, dites brièvement à l'utilisateur quels moments ont été animés et quelle forme d'état a été utilisée, et si des fichiers existants ont été modifiés, listez-les.