Polissage UI
Cette compétence définit le polissage visuel des surfaces, des icônes et des animations, avec la valeur exacte de chaque détail. Elle s'applique une fois que l'interaction sous-jacente est fonctionnelle, et une anomalie de polissage ne prime jamais sur une interaction cassée.
Valeurs exactes, polissage optionnel
Les valeurs ci-dessous sont exactes, pas des plages à approximer. cubic-bezier(0.2, 0, 0, 1) n'est pas cubic-bezier(0.4, 0, 0.2, 1), et 0.96 n'est pas 0.95. Les ajustements optiques et le seuil de remplissage concentrique sont les exceptions. Ce sont des points de départ, jugés à l'œil.
Conservez la bibliothèque de composants, les tokens et la densité du projet, et respectez son langage d'animation lorsqu'aucune règle ici ne donne de valeur. Une convention de projet délibérée et cohérente, comme un style sans ombres, est une préférence et non une anomalie. Le même détail réalisé de deux manières différentes dans le projet constitue une anomalie.
Le retour à la ligne du texte, le rendu des polices, les nombres tabulaires et l'espacement du texte appartiennent à better-typography. Les zones de clic, le support clavier, ARIA et l'exigence de mouvement réduit appartiennent à better-accessibility. Le regroupement, l'espacement des sections, les points de rupture et le RTL spatial appartiennent à better-layout, à l'exception du miroir directionnel des icônes. Les tokens de couleur et la mesure de contraste appartiennent à better-colors.
Le rayon extérieur est égal au rayon intérieur plus le remplissage
Lorsque des surfaces imbriquées partagent un retrait visible et uniforme, le rayon extérieur est le rayon intérieur plus le remplissage plus toute largeur de bordure. Au-delà de 24px de remplissage, ou lorsque le remplissage est délibérément asymétrique, traitez les couches comme des surfaces séparées et conservez le token de rayon de chacune. Les recettes sont dans surfaces.md.
Aligner optiquement là où la géométrie semble incorrecte
Lorsque le centrage géométrique semble incorrect, ajustez à l'œil. Donnez à un bouton 2px de moins de remplissage du côté de son icône, déplacez un triangle de lecture vers sa pointe et corrigez les glyphes asymétriques dans le SVG lui-même. Les recettes sont dans surfaces.md.
Ombres pour l'élévation, bordures pour la structure
Lorsqu'une bordure existe uniquement pour créer de la profondeur, remplacez-la par des valeurs box-shadow transparentes superposées. Conservez les bordures sur les séparateurs, les diviseurs, les cellules de tableau et les états sélectionnés. Conservez-les également sur les entrées de formulaire, dont la limite nécessite un contraste non textuel de 3:1 sous better-accessibility. Les anneaux de focus appartiennent également à better-accessibility.
Le mode couleurs forcées supprime tous les box-shadow. Gardez border: 1px solid transparent sous un anneau d'ombre pour que ce mode dessine toujours un bord. Les recettes sont dans surfaces.md.
Contour des images en noir ou blanc pur
Donnez aux images de contenu un contour 1px en retrait de 1px. Utilisez oklch(0 0 0 / 0.1) en mode clair et oklch(1 0 0 / 0.1) en mode sombre. N'utilisez jamais une palette proche du noir, un neutre teinté ou la couleur d'accentuation, car la teinte apparaît comme une frange colorée sur le bord de l'image. Ignorez les illustrations transparentes telles que les logos et les illustrations. La recette est dans surfaces.md.
Transitions, pas d'animations image par image, pour l'état interactif
Conduisez les changements d'état interactifs avec des transitions CSS ou des ressorts d'une bibliothèque d'animation, qui se recentrent lorsque l'utilisateur fait marche arrière en cours de route. Les animations image par image exécutent une chronologie fixe et ne peuvent pas inverser, réservez-les donc pour les séquences qui se jouent une fois. Voir animations.md.
L'échelle de pression est de 0.96
Un bouton pressé passe à l'échelle 0.96 sur 150ms avec ease-out, et un bouton désactivé ne change jamais d'échelle. Donnez au bouton une option de désactivation lorsque l'animation distrairait, via l'API de variante existante du composant ou une prop static. Voir recettes pour CSS, Tailwind et Motion.
Les interactions à haute fréquence répondent instantanément
Les frappes au clavier, les survols de lignes et les changements d'onglet reçoivent un retour instantané, ou une transition de 150ms ou moins sur opacity ou background-color. Réservez l'animation expressive pour les moments peu fréquents tels que le premier chargement d'une vue, un état de réussite ou un état vide.
Chaque changement d'état animé laisse également un repère statique sous forme de couleur, d'icône ou d'étiquette. L'animation n'est jamais le seul canal de retour.
Limiter l'animation derrière la préférence de mouvement réduit
better-accessibility possède l'exigence, et aucune recette ici n'est livrée sans elle. Exécutez le mouvement, l'échelle et le flou uniquement sous prefers-reduced-motion: no-preference. En mouvement réduit, remplacez-les par un fondu enchaîné d'opacité plutôt que de supprimer l'élément instantanément. Les recettes pour CSS, Tailwind et Motion sont dans animations.md.
Espacement des entrées peu fréquentes de 100ms
Lorsque la séquence communique la hiérarchie dans une entrée graduée, divisez le contenu en blocs sémantiques tels que le titre, la description et les actions. Espacez-les de 100ms, chacun entrant avec opacité, 4px de flou et 12px de translateY sur 300ms avec ease-out. N'espacez jamais les interactions de routine. Voir enter-exit.md.
Les sorties sont plus courtes et plus petites que les entrées
Sortez avec opacité, 4px de flou et un translateY fixe de -12px sur 150ms avec ease-out, jamais la hauteur totale du conteneur. Glissez complètement vers l'extérieur uniquement lorsque la destination a du sens, comme la fermeture d'un tiroir. Supprimez l'élément instantanément lorsque l'animation n'ajoute aucune information. Voir enter-exit.md.
Ignorer les animations d'état lors du premier rendu
Définissez initial={false} sur un AnimatePresence qui englobe un échange d'état, afin que l'état par défaut ne s'anime pas au montage. Ne le définissez jamais autour d'une entrée intentionnelle telle qu'un héros gradué. Voir animations.md.
Fondu enchaîné des icônes contextuelles avec des valeurs exactes
Lorsqu'une icône change lors d'un changement d'état peu fréquent, comme lecture à pause ou copie à copié, faites un fondu enchaîné. L'échelle passe de 0.25 à 1, l'opacité de 0 à 1 et le flou de 4px à 0px. Avec une bibliothèque d'animation, utilisez { type: "spring", duration: 0.3, bounce: 0 }, et le rebond est toujours 0. Sans bibliothèque, gardez les deux icônes dans le DOM et faites un fondu enchaîné sur 300ms avec cubic-bezier(0.2, 0, 0, 1).
Le changement d'icône d'un onglet et les actions qu'une ligne révèle au survol relèvent de Les interactions à haute fréquence répondent instantanément. Les deux recettes sont dans icon-transitions.md.
Supprimer les transitions lors du changement de thème
Désactivez chaque transition pour l'échange de thème, forcez un vidage de style et restaurez les transitions après l'image suivante. Sinon, chaque transition de couleur se déclenche en même temps et le changement devient flou. Voir la recette.
Transitionner uniquement ce qui change
Nommez les propriétés exactes, comme dans transition-property: scale, opacity, et jamais all. Voir performance.md.
Nommer la propriété animée dans will-change
Ajoutez will-change uniquement après avoir observé un bégaiement de la première image, et nommez la propriété que vous animez : scale pour scale, transform pour transform. Limitez-la aux propriétés de transformation, opacity et filter, et n'utilisez jamais all. Voir performance.md.
Effets de survol uniquement sur les pointeurs capables de survol
Placez le style de survol uniquement derrière @media (hover: hover). Sur le tactile, :hover se verrouille après un tap et apparaît comme un état sélectionné bloqué. La variante hover: de Tailwind 4 se compile déjà sous cette requête, contrairement à celle de Tailwind 3. Lorsqu'un contrôle dessine son propre état pressé, définissez -webkit-tap-highlight-color: transparent pour que le flash gris par défaut ne le double pas.
Contenir le défilement dans les superpositions
Donnez aux boîtes de dialogue, tiroirs, menus et panneaux latéraux défilables overscroll-behavior: contain, afin que le défilement au-delà de leur fin ne fasse jamais défiler la page derrière.
Faire correspondre l'épaisseur du trait de l'icône au poids du texte
L'épaisseur du trait rendue d'une icône suit le poids du texte à côté d'elle, de 1.5px à 400 à 2.5px à 700. Utilisez une bibliothèque d'icônes par surface. Le tableau, les règles de taille et de grille sont dans icons.md.
Un seul SVG, recoloré par état
Les icônes utilisent currentColor et prennent les états de survol, sélectionné et désactivé de la couleur et de l'opacité CSS, jamais d'actifs séparés. Le contour est la variante par défaut, et le remplissage marque l'état actif. Sous dir="rtl", ne mettez en miroir que les icônes dont la signification suit le sens de lecture. Voir icons.md.
Avant de terminer
| Détection | Correction |
|---|---|
Parent et enfant avec le même rounded-* ou border-radius | Ajoutez le remplissage au rayon extérieur |
Anneau box-shadow: 0 0 0 1px sans border à côté | border: 1px solid transparent |
outline-slate-*, outline-zinc-* ou une couleur de contour hexadécimale sur img | outline-black/10 et dark:outline-white/10 |
transition-all ou transition: all | Nommez les propriétés changeantes |
animation: définie sur :hover, .open ou une autre classe basculée | Une transition sur les mêmes propriétés |
active:scale-95, scale-90 ou whileTap en dessous de 0.96 | 0.96 |
Échelle :active sans exclusion :disabled | enabled:active: ou :not(:disabled):active |
bounce: réglé sur autre chose que 0 | bounce: 0 |
opacity: 0 dans une règle de base que seule une animation révèle | État caché dans l'image clé from, animation-fill-mode: both |
Animation translate, scale, filter ou motion.* sans protection prefers-reduced-motion, motion-safe: ou MotionConfig | Limitez-la et faites un fondu enchaîné d'opacité en mouvement réduit |
Transitions de couleur plus un bouton de thème sans disableTransitionOnChange ou remplacement | La recette de suppression du changement de thème |
will-change: all, ou will-change sur un élément qui n'anime jamais | Nommez la propriété animée ou supprimez-la |
fill="#..." ou stroke="#..." à l'intérieur d'un SVG d'icône | currentColor |
:hover CSS simple ou hover: Tailwind 3 en dehors de @media (hover: hover) | Encapsulez-le dans la requête |
overflow: auto ou overflow-y-auto sur une boîte de dialogue, un tiroir ou un menu sans overscroll-behavior | overscroll-behavior: contain |
Rapport
Sévérité. HIGH casse une interaction, comme une animation image par image qui ne peut pas inverser ou un état de survol bloqué au toucher. Deux des déclencheurs d'escalade de better-interface atterrissent ici et sont HIGH de vue. L'un est une animation qui ignore prefers-reduced-motion, et l'autre est un changement d'état porté par la seule animation. MEDIUM est une incohérence visible dans les surfaces, les icônes ou les animations. LOW est un polissage isolé.
Vérification. Sans navigateur, lisez chaque état que le composant définit à partir du code, comme le survol, la pression, la sélection, le chargement et le vide, avec ses durées et ses easings. Avec un, parcourez chaque état et rejouez l'animation à 10 % de vitesse dans le panneau Animations du navigateur. Signalez chaque vérification que vous n'avez pas pu exécuter comme Non vérifié.
Format. Regroupez les constatations sous le principe que chacune viole, classées par sévérité, une ligne par cause racine listant chaque emplacement où elle apparaît :
| Sévérité | Emplacement | Avant | Après | Pourquoi |
|---|
Emplacement est chemin/vers/fichier:ligne. Pourquoi nomme le principe et l'impact utilisateur.
Terminez par Bloquer lorsqu'il reste des HIGH, Approuver sinon, en laissant le reste dans le tableau comme travail à faire. N'Approuvez jamais une couverture que vous n'avez pas inspectée. S'il n'y a rien à signaler, indiquez "Aucune constatation de polissage UI exploitable" et signalez la vérification.