UI-Politur
Dieser Skill enthält die visuelle Politur für Oberflächen, Symbole und Bewegungen, mit dem genauen Wert jedes Details. Er wird angewendet, sobald die zugrunde liegende Interaktion einwandfrei ist, und ein Politurbefund hat nie Vorrang vor einer defekten Interaktion.
Exakte Werte, optionale Politur
Die Werte unten sind exakt, keine Bereiche, die angenähert werden. cubic-bezier(0.2, 0, 0, 1) ist nicht cubic-bezier(0.4, 0, 0.2, 1), und 0.96 ist nicht 0.95. Die optischen Korrekturen und der konzentrische Auffüllungs-Grenzwert sind die Ausnahmen. Sie sind Ausgangspunkte, die nach Augenmaß beurteilt werden.
Behalte die Komponentenbibliothek, Tokens und Dichte des Projekts bei und passe die Bewegungssprache des Projekts an, wo immer keine Regel hier einen Wert vorgibt. Eine bewusste und konsistente Projektkonvention, wie z.B. ein Stil ohne Schatten, ist eine Präferenz und kein Befund. Das gleiche Detail auf zwei Arten im Projekt umgesetzt ist ein Befund.
Textumbruch, Schriftdarstellung, tabellarische Zahlen und Textabstände gehören zu better-typography. Trefferflächen, Tastaturunterstützung, ARIA und die Anforderung an reduzierte Bewegung gehören zu better-accessibility. Gruppierung, Abschnittsabstände, Haltepunkte und räumliches RTL gehören zu better-layout, mit Ausnahme der Spiegelung von Richtungssymbolen. Farb-Tokens und Kontrastmessung gehören zu better-colors.
Äußerer Radius gleich innerem Radius plus Auffüllung
Wo verschachtelte Oberflächen einen sichtbaren, gleichmäßigen Innenabstand teilen, ist der äußere Radius der innere Radius plus die Auffüllung plus jegliche Rahmenbreite. Ab 24px Auffüllung oder wo die Auffüllung bewusst asymmetrisch ist, behandle die Schichten als separate Oberflächen und behalte den Radius-Token jeder einzelnen bei. Rezepte sind in surfaces.md.
Optisch ausrichten, wo die Geometrie falsch aussieht
Wo die geometrische Zentrierung falsch aussieht, korrigiere nach Augenmaß. Gib einem Button 2px weniger Auffüllung auf seiner Symbolseite, verschiebe ein Play-Dreieck in Richtung seiner Spitze und korrigiere asymmetrische Glyphen im SVG selbst. Rezepte sind in surfaces.md.
Schatten für Höhe, Rahmen für Struktur
Wo ein Rahmen nur dazu da ist, Tiefe zu erzeugen, ersetze ihn durch geschichtete transparente box-shadow-Werte. Behalte Rahmen bei Trennlinien, Separatoren, Tabellenzellen und ausgewählten Zuständen. Behalte sie auch bei Formulareingaben, deren Grenze unter better-accessibility einen Nicht-Text-Kontrast von 3:1 benötigt. Fokusringe gehören ebenfalls zu better-accessibility.
Der forced-colors-Modus entfernt jedes box-shadow. Behalte border: 1px solid transparent unter einem Schattenring, damit dieser Modus immer noch eine Kante zeichnet. Rezepte sind in surfaces.md.
Bilder in reinem Schwarz oder Weiß umranden
Gib Inhaltsbildern einen 1px-Umriss, der um 1px eingerückt ist. Verwende oklch(0 0 0 / 0.1) im hellen Modus und oklch(1 0 0 / 0.1) im dunklen. Verwende niemals eine fast-schwarze Palette, einen getönten Neutralton oder die Akzentfarbe, da die Tönung als farbiger Saum am Bildrand erscheint. Überspringe transparente Grafiken wie Logos und Illustrationen. Das Rezept ist in surfaces.md.
Übergänge, keine Keyframes, für interaktive Zustände
Steuere Änderungen des interaktiven Zustands mit CSS-Übergängen oder den Federn einer Bewegungsbibliothek, die neu ausgerichtet werden, wenn der Benutzer mitten im Flug umkehrt. Keyframes laufen auf einer festen Zeitleiste und können nicht umkehren, reserviere sie daher für Sequenzen, die einmal ablaufen. Siehe animations.md.
Drücken skaliert auf 0.96
Ein gedrückter Button skaliert auf 0.96 über 150ms mit ease-out, und ein deaktivierter skaliert nie. Gib dem Button eine Opt-out-Möglichkeit, wo die Bewegung ablenken würde, über die vorhandene Varianten-API der Komponente oder eine static-Prop. Siehe Rezepte für CSS, Tailwind und Motion.
Hochfrequente Interaktionen reagieren sofort
Tastaturanschläge, Zeilen-Hover und Tab-Wechsel erhalten sofortiges Feedback oder einen Übergang von 150ms oder weniger auf opacity oder background-color. Reserviere ausdrucksstarke Bewegungen für seltene Momente wie das erste Laden einer Ansicht, einen Erfolgszustand oder einen leeren Zustand.
Jede animierte Zustandsänderung hinterlässt auch einen statischen Hinweis in Form einer Farbe, eines Symbols oder einer Beschriftung. Bewegung ist niemals der einzige Feedback-Kanal.
Bewegung hinter die Präferenz für reduzierte Bewegung stellen
better-accessibility besitzt die Anforderung, und kein Rezept hier wird ohne sie ausgeliefert. Führe Bewegung, Skalierung und Unschärfe nur unter prefers-reduced-motion: no-preference aus. Ersetze sie bei reduzierter Bewegung durch einen Opazitäts-Überblendungseffekt, anstatt das Element sofort zu entfernen. Rezepte für CSS, Tailwind und Motion sind in animations.md.
Seltene Eingänge um 100ms staffeln
Wo Sequenz Hierarchie in einem gestaffelten Eingang kommuniziert, teile den Inhalt in semantische Blöcke wie Titel, Beschreibung und Aktionen. Staffle sie 100ms auseinander, jeder mit Opazität, 4px Unschärfe und 12px translateY über 300ms mit ease-out. Staffle niemals Routine-Interaktionen. Siehe enter-exit.md.
Ausgänge sind kürzer und kleiner als Eingänge
Verlasse mit Opazität, 4px Unschärfe und einem festen -12px translateY über 150ms mit ease-out, niemals die gesamte Container-Höhe. Schiebe nur vollständig heraus, wo das Ziel Bedeutung trägt, wie z.B. beim Schließen einer Schublade. Entferne das Element sofort, wo Bewegung keine zusätzlichen Informationen liefert. Siehe enter-exit.md.
Zustandsanimationen beim ersten Rendern überspringen
Setze initial={false} auf ein AnimatePresence, das einen Zustandswechsel umschließt, damit der Standardzustand beim Einfügen nicht animiert wird. Setze es niemals um einen absichtlichen Eingang wie einen gestaffelten Helden. Siehe animations.md.
Kontextuelle Symbole mit exakten Werten überblenden
Wo ein Symbol bei einem seltenen Zustandswechsel wechselt, z.B. von Play zu Pause oder von Kopieren zu Kopiert, überblende es. Skalierung läuft von 0.25 bis 1, Opazität von 0 bis 1 und Unschärfe von 4px bis 0px. Verwende mit einer Bewegungsbibliothek { type: "spring", duration: 0.3, bounce: 0 }, und Bounce ist immer 0. Ohne eine solche Bibliothek behalte beide Symbole im DOM und überblende über 300ms mit cubic-bezier(0.2, 0, 0, 1).
Der Symbolwechsel eines Tabs und die Aktionen, die eine Zeile beim Hover preisgibt, fallen unter Hochfrequente Interaktionen reagieren sofort. Beide Rezepte sind in icon-transitions.md.
Übergänge beim Themenwechsel unterdrücken
Deaktiviere jeden Übergang für den Themenwechsel, erzwinge einen Stil-Flush und stelle die Übergänge nach dem nächsten Frame wieder her. Andernfalls feuern alle Farbübergänge auf einmal und der Wechsel verschmiert. Siehe das Rezept.
Nur das ändern, was sich ändert
Benenne die genauen Eigenschaften, wie in transition-property: scale, opacity, und niemals all. Siehe performance.md.
Die animierte Eigenschaft in will-change benennen
Füge will-change erst hinzu, nachdem du ein Ruckeln im ersten Frame siehst, und benenne die Eigenschaft, die du animierst: scale für scale, transform für transform. Beschränke es auf Transform-Eigenschaften, opacity und filter, und verwende niemals all. Siehe performance.md.
Hover-Effekte nur auf hover-fähigen Zeigern
Setze Hover-only-Stile hinter @media (hover: hover). Auf Touch-Geräten rastet :hover nach einem Tippen ein und wird als hängender Auswahlzustand gelesen. Tailwind 4's hover: Variante kompiliert bereits unter dieser Abfrage, Tailwind 3's nicht. Wo ein Steuerelement seinen eigenen gedrückten Zustand zeichnet, setze -webkit-tap-highlight-color: transparent, damit der standardmäßige graue Blitz ihn nicht verdoppelt.
Scrollen in Overlays begrenzen
Gib scrollbaren Dialogen, Drawern, Menüs und Seitenbereichen overscroll-behavior: contain, damit das Scrollen über ihr Ende hinaus niemals die Seite darunter scrollt.
Symbolstrich an Textgewicht anpassen
Der gerenderte Strich eines Symbols folgt dem Gewicht des Textes daneben, von 1.5px bei 400 bis 2.5px bei 700. Verwende eine Symbolbibliothek pro Oberfläche. Die Tabelle, Größenregeln und Gitterregeln sind in icons.md.
Ein SVG, pro Zustand neu eingefärbt
Icons verwenden currentColor und nehmen Hover-, Ausgewählt- und Deaktiviert-Zustände von CSS-Farbe und Opazität an, niemals von separaten Assets. Umriss ist die Standardvariante, und Füllung markiert den aktiven Zustand. Unter dir="rtl" spiegele nur Symbole, deren Bedeutung der Leserichtung folgt. Siehe icons.md.
Bevor du fertig bist
| Erkennung | Lösung |
|---|---|
Mit rounded-* oder border-radius versehenes Elternteil und Kind | Füge die Auffüllung zum äußeren Radius hinzu |
box-shadow: 0 0 0 1px Ring ohne border daneben | border: 1px solid transparent |
outline-slate-*, outline-zinc-* oder eine Hex-Umrissfarbe auf img | outline-black/10 und dark:outline-white/10 |
transition-all oder transition: all | Benenne die sich ändernden Eigenschaften |
animation: gesetzt auf :hover, .open oder eine andere umgeschaltete Klasse | Ein Übergang auf denselben Eigenschaften |
active:scale-95, scale-90 oder whileTap unter 0.96 | 0.96 |
:active Skalierung ohne :disabled Ausnahme | enabled:active: oder :not(:disabled):active |
bounce: auf etwas anderes als 0 gesetzt | bounce: 0 |
opacity: 0 in einer Basisregel, die nur eine animation enthüllt | Versteckter Zustand im from-Keyframe, animation-fill-mode: both |
translate, scale, filter oder motion.* Animation ohne prefers-reduced-motion, motion-safe: oder MotionConfig Schutz | Schütze sie und überblende die Opazität bei reduzierter Bewegung |
Farbübergänge plus einen Themenwechsel ohne disableTransitionOnChange oder Überschreibung | Das Rezept zur Unterdrückung des Themenwechsels |
will-change: all, oder will-change auf einem Element, das niemals animiert | Benenne die animierte Eigenschaft oder lösche sie |
fill="#..." oder stroke="#..." in einem Icon-SVG | currentColor |
Plain-CSS :hover oder Tailwind 3 hover: außerhalb von @media (hover: hover) | Wickele sie in die Abfrage ein |
overflow: auto oder overflow-y-auto auf einem Dialog, Drawer oder Menü ohne overscroll-behavior | overscroll-behavior: contain |
Berichterstattung
Schweregrad. HIGH bricht eine Interaktion, wie ein Keyframe-Umschalter, der nicht umkehren kann, oder ein Hover-Zustand, der auf Touch-Geräten hängen bleibt. Zwei Eskalationsauslöser von better-interface landen hier und sind HIGH auf den ersten Blick. Einer ist Bewegung, die prefers-reduced-motion ignoriert, und der andere ist eine Zustandsänderung, die nur durch Bewegung getragen wird. MEDIUM ist eine sichtbare Inkonsistenz in Oberflächen, Symbolen oder Bewegungen. LOW ist isolierte Politur.
Verifizierung. Ohne Browser lese jeden Zustand, den die Komponente definiert, aus dem Code, wie Hover, Gedrückt, Ausgewählt, Laden und Leer, mit seinen Dauern und Easings. Mit einem Browser durchlaufe jeden Zustand und spiele Bewegung bei 10% Geschwindigkeit im Animations-Panel des Browsers ab. Melde jede Überprüfung, die du nicht durchführen konntest, als Not verified.
Format. Gruppiere Befunde nach dem Prinzip, das jedes verletzt, geordnet nach Schweregrad, eine Zeile pro Grundursache, die jeden Ort auflistet, an dem sie erscheint:
| Schweregrad | Ort | Vorher | Nachher | Warum |
|---|
Ort ist Pfad/zur/Datei:Zeile. Warum nennt das Prinzip und die Auswirkung auf den Benutzer.
Beende mit Block, wenn ein HIGH übrig bleibt, andernfalls mit Approve, wobei der Rest in der Tabelle als zu erledigende Arbeit bleibt. Gib niemals Approve für eine Abdeckung, die du nicht geprüft hast. Wenn es nichts zu melden gibt, gib an: "Keine umsetzbaren UI-Politur-Befunde" und melde die Verifizierung.