Les détails qui rendent les interfaces meilleures
Les grandes interfaces viennent rarement d'une seule chose. C'est généralement une collection de petits détails qui se combinent en une excellente expérience. Appliquez ces principes lors de la construction ou de la révision de code UI.
Lors de la révision, ralentissez l'interface : rejouez l'animation à 10% de la vitesse dans le panneau Animations du navigateur et parcourez chaque état : survol, focus, actif, chargement, vide. Ce qui semble étrange à 10% de la vitesse est ce qui est subtilement faux à pleine vitesse.
Préservez la bibliothèque de composants, les tokens et la densité du projet. Adaptez-vous à son langage de mouvement établi, sauf si un principe ci-dessous prescrit un modèle d'interaction exact.
La typographie (habillage du texte, rendu des polices, chiffres tabulaires, espacement) est couverte par le skill better-typography ; utilisez-le pour tout ce qui concerne le texte. L'accessibilité (zones de clic, états de focus, support clavier, ARIA, mouvement réduit) est couverte par le skill better-accessibility. La structure de mise en page (regroupement, espacement entre les sections, points de rupture, RTL spatial) est couverte par le skill better-layout.
Référence rapide
| Catégorie | Quand l'utiliser |
|---|---|
| Surfaces | Rayon de bordure, alignement optique, ombres, contours d'image |
| Animations | Animations interruptibles, transitions d'entrée/sortie, animations d'icônes, échelle à la pression, retenue dans les mouvements |
| Icônes | Épaisseur du trait des icônes, états via currentColor, contour vs remplissage, dimensionnement, retournement RTL |
| Performance | Spécificité des transitions, utilisation de will-change |
Principes fondamentaux
1. Rayon de bordure concentrique
Rayon extérieur = rayon intérieur + remplissage. Des rayons mal assortis sur des éléments imbriqués est la chose la plus courante qui fait que les interfaces semblent décalées.
2. Alignement optique plutôt que géométrique
Lorsque le centrage géométrique semble décalé, alignez optiquement. Les boutons avec icônes, les triangles de lecture et les icônes asymétriques ont tous besoin d'un ajustement manuel.
3. Ombres pour l'élévation, bordures pour la structure
Pour les boutons, cartes et conteneurs dont la bordure existe uniquement pour créer de la profondeur, préférez des valeurs box-shadow transparentes superposées. Gardez les bordures qui communiquent la structure ou l'état : séparateurs, séparateurs de mise en page, états sélectionnés ou de focus.
4. Animations interruptibles
Utilisez les transitions CSS pour les changements d'état interactifs : elles peuvent être interrompues au milieu de l'animation. Réservez les images clés pour les séquences scénarisées qui s'exécutent une fois.
5. Animations d'entrée fractionnées et décalées
Pour une entrée scénarisée peu fréquente où la séquence aide à communiquer la hiérarchie, divisez le contenu en blocs sémantiques et décalez-les d'environ 100 ms au lieu d'animer un seul conteneur. Ne décalez pas les interactions routinières et à haute fréquence.
6. Animations de sortie subtiles
Utilisez un petit translateY fixe au lieu de la hauteur totale. Les sorties doivent être plus douces que les entrées. Utilisez ease-out pour les transitions d'entrée et de sortie.
7. Animations d'icônes contextuelles
Animez les icônes avec opacity, scale et blur au lieu de basculer la visibilité. Utilisez exactement ces valeurs : mise à l'échelle de 0.25 à 1, opacité de 0 à 1, flou de 4px à 0px. Si le projet a motion ou framer-motion dans package.json, utilisez le chemin d'importation de ce package (ou les importations établies à proximité lorsque les deux existent) et utilisez transition: { type: "spring", duration: 0.3, bounce: 0 } ; bounce doit toujours être 0. Si aucune bibliothèque de mouvement n'est installée, gardez les deux icônes dans le DOM (une positionnée en absolu) et faites un fondu croisé avec des transitions CSS en utilisant cubic-bezier(0.2, 0, 0, 1) ; cela donne à la fois des animations d'entrée et de sortie sans aucune dépendance.
8. Contours d'image
Ajoutez un contour subtil de 1px avec une faible opacité aux images pour une profondeur cohérente. La couleur doit être du noir pur en mode clair (oklch(0 0 0 / 0.1)) et du blanc pur en mode sombre (oklch(1 0 0 / 0.1)), jamais un noir approchant comme l'ardoise, le zinc ou tout neutre teinté. Un contour teinté capte la couleur de la surface en dessous et ressemble à de la saleté sur le bord de l'image.
9. Échelle à la pression
Un scale(0.96) subtil au clic donne un retour tactile aux boutons. Utilisez toujours 0.96. N'utilisez jamais une valeur inférieure à 0.95 : tout ce qui est en dessous semble exagéré. Ajoutez une prop static pour le désactiver lorsque le mouvement serait distrayant.
10. Ignorer l'animation au chargement de la page
Utilisez initial={false} sur AnimatePresence pour empêcher les animations d'entrée lors du premier rendu. Vérifiez qu'il ne casse pas les animations d'entrée intentionnelles.
11. Ne jamais utiliser transition: all
Spécifiez toujours les propriétés exactes : transition-property: scale, opacity. transition-transform de Tailwind couvre transform, translate, scale, rotate.
12. Utiliser will-change avec parcimonie
Uniquement pour transform, opacity, filter, les propriétés que le GPU peut composer. N'utilisez jamais will-change: all. N'ajoutez que lorsque vous remarquez un bégaiement sur la première image.
13. Faire correspondre l'épaisseur du trait de l'icône au poids du texte
Une icône à côté d'un texte porte le poids optique du texte : trait de 1.5px à côté d'un texte régulier (400), trait de 2px à côté d'un semi-gras (600). Une épaisseur de trait par jeu d'icônes ; ne mélangez jamais les bibliothèques sur une seule surface.
14. Un seul SVG, recoloré par état
Les icônes utilisent currentColor et obtiennent leurs états (survol, sélectionné, désactivé) à partir de la couleur et de l'opacité CSS, jamais à partir de ressources séparées. La variante de contour est la valeur par défaut ; la variante de remplissage marque l'état actif.
15. Retenue dans les mouvements
Pas d'animation personnalisée sur les interactions à haute fréquence : le coût d'attention se répète à chaque déclencheur. Le mouvement n'est jamais le seul canal de rétroaction ; chaque changement d'état animé a également besoin d'un indice statique (couleur, icône, étiquette).
Erreurs courantes
| Erreur | Correctif |
|---|---|
| Même rayon de bordure sur un parent et un enfant étroitement imbriqués | Calculez rayonExtérieur = rayonIntérieur + remplissage |
| Les icônes semblent décentrées | Ajustez optiquement avec un remplissage ou corrigez le SVG directement |
| Bordure utilisée uniquement pour simuler l'élévation | Utilisez box-shadow superposées avec transparence ; conservez les bordures structurelles et d'état |
| Entrée scénarisée saccadée ou sortie contextuelle | Décalez les entrées peu fréquentes et gardez les sorties contextuelles subtiles |
| Une icône d'état ou un bouton bascule anime son état par défaut au chargement de la page | Ajoutez initial={false} à cet AnimatePresence ; préservez les entrées de page intentionnelles |
transition: all sur les éléments | Spécifiez les propriétés exactes |
| Bégaiement de l'animation sur la première image | Ajoutez will-change: transform (avec parcimonie) |
| Icône au trait fin à côté d'un texte en gras | Faites correspondre l'épaisseur du trait au poids du texte |
| Ressources d'icônes séparées par état | Un SVG currentColor, états via CSS |
| Icônes remplies partout | Contour par défaut, remplissage uniquement pour l'état actif |
| Animation d'entrée à chaque survol ou frappe | Retour instantané ou transition d'opacité/couleur ≤150ms |
Format de sortie de la révision
Utilisez ce format uniquement lorsque l'utilisateur demande une révision autonome du polish UI. Lorsque better-interface orchestre la révision, fournissez des preuves de domaine et des conclusions à ce skill et laissez son format de sortie, son échelle de gravité, ses règles de consolidation, son plafond et son verdict prévaloir.
Présentez la révision autonome en deux parties.
Constats
Regroupez tous les constats confirmés par principe. Utilisez un tableau markdown avec les colonnes Gravité, Emplacement, Avant, Après et Pourquoi. N'utilisez jamais de lignes "Avant :" / "Après :" séparées.
- Gravité :
ÉLEVÉErend une interaction trompeuse, non réactive ou perturbatrice de manière répétée ;MOYENNEcrée un problème notable de savoir-faire ou de cohérence ;FAIBLEest un polish isolé. - Emplacement : citez
chemin/vers/fichier:ligne. Si l'artefact n'a pas de fichiers sources, citez l'écran et le composant exacts à la place. - Avant / Après : montrez l'implémentation actuelle et un remplacement actionnable.
- Pourquoi : nommez le principe violé et expliquez comment il affecte l'interface.
Consolidez un problème systémique récurrent en une seule ligne et listez chaque emplacement affecté. Omettez les principes sans constats.
Exemple
Rayon de bordure concentrique
| Gravité | Emplacement | Avant | Après | Pourquoi |
|---|---|---|---|---|
| FAIBLE | src/Card.tsx:28 | rounded-xl sur la carte + rounded-xl sur le bouton intérieur (p-2) | rounded-2xl sur la carte (8 + 8 = 16), rounded-lg sur le bouton intérieur | Les coins imbriqués doivent être concentriques |
| FAIBLE | src/card.css:11 | border-radius: 16px sur les deux surfaces imbriquées | Extérieur 24px, intérieur 16px avec un remplissage de 8px | Des rayons imbriqués égaux donnent l'impression que la surface intérieure est pincée |
Échelle à la pression
| Gravité | Emplacement | Avant | Après | Pourquoi |
|---|---|---|---|---|
| FAIBLE | src/Button.tsx:19 | <button className="..."> | Ajoutez active:scale-[0.96] transition-transform | Le retour de pression rend le contrôle réactif |
| MOYENNE | src/button.css:24 | scale(0.9) à la pression | Passez à scale(0.96) | Tout ce qui est en dessous de 0.95 semble exagéré |
Vérification et verdict
Après les constats :
- Vérification : listez les vérifications exactes effectuées et leurs résultats observés. Parcourez chaque état pertinent et inspectez le mouvement à 10% de la vitesse lorsque l'animation est impliquée. Si une vérification n'a pas été effectuée, indiquez ce qui doit encore être vérifié.
- Verdict :
Bloquersi un constatÉLEVÉdemeure,Modifications nécessairessi seuls des constatsMOYENouFAIBLEsubsistent, etApprouveruniquement lorsqu'aucun constat actionnable ne subsiste.
Lorsqu'il n'y a aucun constat, omettez les tableaux, indiquez "Aucun constat actionnable de polish UI", rapportez la vérification et terminez par Approuver.