Communitygithub.com

better-ui

Polit les surfaces, les icônes et les animations avec des valeurs exactes pour les rayons de bordure, l'alignement optique, les ombres, les états d'icônes et l'animation.

Qu'est-ce que better-ui ?

Cette compétence (skill) définit des règles précises et quantifiables pour le polissage visuel de l'interface utilisateur : surfaces, icônes et animations. Elle intervient une fois que l'interaction sous-jacente est fonctionnelle et ne remplace jamais une interaction cassée. Le skill fournit des valeurs exactes (ex. `cubic-bezier(0.2, 0, 0, 1)`, `scale(0.96)`), des recettes pour les ombres, les transitions et les entrées/sorties, ainsi que des directives pour l'alignement optique, les contours d'images et l'adaptation au mode de contraste forcé. Il s'applique principalement aux agents de développement front-end (Claude Code, Cursor, Codex) et s'intègre avec d'autres compétences comme `better-colors`, `better-typography` et `better-accessibility` pour une approche modulaire. Les violations sont identifiées via un tableau de détection et rapportées avec une sévérité (HIGH, MEDIUM, LOW), validées par inspection du code et des animations.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Atou4/skillsmith/tree/HEAD/skills/ui-ux/better-ui

Demander à votre IA préférée

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

Documentation

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étectionCorrection
Parent et enfant avec le même rounded-* ou border-radiusAjoutez 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 imgoutline-black/10 et dark:outline-white/10
transition-all ou transition: allNommez les propriétés changeantes
animation: définie sur :hover, .open ou une autre classe basculéeUne transition sur les mêmes propriétés
active:scale-95, scale-90 ou whileTap en dessous de 0.960.96
Échelle :active sans exclusion :disabledenabled:active: ou :not(:disabled):active
bounce: réglé sur autre chose que 0bounce: 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 MotionConfigLimitez-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 remplacementLa recette de suppression du changement de thème
will-change: all, ou will-change sur un élément qui n'anime jamaisNommez la propriété animée ou supprimez-la
fill="#..." ou stroke="#..." à l'intérieur d'un SVG d'icônecurrentColor
: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-behavioroverscroll-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éEmplacementAvantAprèsPourquoi

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.

Skills associés