Details, die Interfaces besser machen
Großartige Interfaces entstehen selten aus einer einzelnen Sache. Es ist meist eine Sammlung kleiner Details, die sich zu einem großartigen Erlebnis summieren. Wende diese Prinzipien beim Erstellen oder Überprüfen von UI-Code an.
Verlangsame bei Überprüfungen das Interface: Spiele Bewegungen im Animationsbereich des Browsers mit 10% Geschwindigkeit ab und gehe jeden Zustand durch: Hover, Fokus, Aktiv, Laden, Leer. Was sich bei 10% Geschwindigkeit falsch anfühlt, ist das, was bei voller Geschwindigkeit subtil falsch ist.
Behalte die Komponentenbibliothek, Tokens und Dichte des Projekts bei. Passe dich der etablierten Bewegungssprache an, außer wenn ein untenstehendes Prinzip ein bestimmtes Interaktionsmuster vorschreibt.
Typografie (Textumbruch, Schriftdarstellung, tabellarische Zahlen, Abstände) wird durch den Skill better-typography abgedeckt; verwende diesen für alles Textbezogene. Barrierefreiheit (Trefferflächen, Fokus-Zustände, Tastaturunterstützung, ARIA, reduzierte Bewegung) wird durch den Skill better-accessibility abgedeckt. Layout-Struktur (Gruppierung, Abstände zwischen Abschnitten, Breakpoints, räumliches RTL) wird durch den Skill better-layout abgedeckt.
Kurzreferenz
| Kategorie | Wann verwenden |
|---|---|
| Oberflächen | Rahmenradius, optische Ausrichtung, Schatten, Bildumrisse |
| Animationen | Unterbrechbare Animationen, Ein-/Ausgangsübergänge, Icon-Animationen, Skalierung beim Drücken, Bewegungszurückhaltung |
| Icons | Icon-Strichstärke, Zustände via currentColor, Umriss vs. Füllung, Größenanpassung, RTL-Spiegelung |
| Leistung | Übergangsspezifität, will-change-Verwendung |
Kernprinzipien
1. Konzentrischer Rahmenradius
Außenradius = Innenradius + Abstand. Nicht übereinstimmende Radien bei verschachtelten Elementen sind das häufigste, wodurch sich Interfaces falsch anfühlen.
2. Optische vs. geometrische Ausrichtung
Wenn die geometrische Zentrierung falsch aussieht, optisch ausrichten. Buttons mit Icons, Play-Dreiecke und asymmetrische Icons benötigen alle manuelle Anpassung.
3. Schatten für Höhe, Rahmen für Struktur
Bei Buttons, Karten und Containern, deren Rahmen nur der Tiefe dient, sollten geschichtete transparente box-shadow-Werte bevorzugt werden. Behalte Rahmen, die Struktur oder Zustand kommunizieren: Trennlinien, Layout-Trenner und ausgewählte oder Fokus-Zustände.
4. Unterbrechbare Animationen
Verwende CSS-Übergänge für interaktive Zustandsänderungen: Sie können mitten in der Animation unterbrochen werden. Behalte Keyframes für inszenierte Sequenzen vor, die einmal ablaufen.
5. Aufgeteilte und gestaffelte Eingangsanimationen
Bei einem seltenen inszenierten Eingang, bei dem die Reihenfolge zur Vermittlung der Hierarchie beiträgt, teile den Inhalt in semantische Blöcke auf und staffele sie um ~100ms, anstatt einen Container zu animieren. Staffele keine routinemäßigen, hochfrequenten Interaktionen.
6. Subtile Ausgangsanimationen
Verwende einen kleinen festen translateY anstelle der vollen Höhe. Ausgänge sollten weicher sein als Eingänge. Verwende ease-out sowohl für Eingangs- als auch für Ausgangsübergänge.
7. Kontextbezogene Icon-Animationen
Animiere Icons mit opacity, scale und blur anstatt die Sichtbarkeit umzuschalten. Verwende genau diese Werte: Skalierung von 0.25 auf 1, Deckkraft von 0 auf 1, Weichzeichnung von 4px auf 0px. Wenn das Projekt motion oder framer-motion in package.json hat, verwende den Importpfad dieser Bibliothek (oder die etablierten nahegelegenen Importe, wenn beide existieren) und verwende transition: { type: "spring", duration: 0.3, bounce: 0 }; bounce muss immer 0 sein. Wenn keine Bewegungsbibliothek installiert ist, behalte beide Icons im DOM (eines absolut positioniert) und überblende sie mit CSS-Übergängen unter Verwendung von cubic-bezier(0.2, 0, 0, 1); dies ergibt sowohl Eingangs- als auch Ausgangsanimationen ohne Abhängigkeit.
8. Bildumrisse
Füge einen subtilen 1px-Umriss mit geringer Deckkraft zu Bildern hinzu, um eine konsistente Tiefe zu erzielen. Die Farbe muss im hellen Modus reines Schwarz sein (oklch(0 0 0 / 0.1)) und im dunklen Modus reines Weiß (oklch(1 0 0 / 0.1)), niemals ein Fast-Schwarz wie Schiefer, Zink oder ein getönter Neutralton. Ein getönter Umriss nimmt die darunterliegende Oberflächenfarbe auf und wirkt wie Schmutz am Bildrand.
9. Skalierung beim Drücken
Ein subtiles scale(0.96) beim Klicken gibt Buttons ein taktiles Feedback. Verwende immer 0.96. Verwende niemals einen Wert kleiner als 0.95: Alles darunter wirkt übertrieben. Füge eine static-Eigenschaft hinzu, um es zu deaktivieren, wenn Bewegung ablenken würde.
10. Animation beim Seitenaufbau überspringen
Verwende initial={false} bei AnimatePresence, um Eingangsanimationen beim ersten Rendern zu verhindern. Überprüfe, dass es nicht beabsichtigte Eingangssanimationen unterbricht.
11. Niemals transition: all verwenden
Gib immer genaue Eigenschaften an: transition-property: scale, opacity. Tailwinds transition-transform deckt transform, translate, scale, rotate ab.
12. will-change sparsam verwenden
Nur für transform, opacity, filter, die Eigenschaften, die die GPU zusammenstellen kann. Verwende niemals will-change: all. Füge es nur hinzu, wenn du ein Ruckeln im ersten Frame bemerkst.
13. Icon-Strichstärke an das Textgewicht anpassen
Ein Icon neben Text trägt das optische Gewicht des Textes: 1.5px Strich neben regulärem (400) Text, 2px neben halbfettem (600). Eine Strichstärke pro Icon-Set; mische niemals Bibliotheken auf einer Oberfläche.
14. Ein SVG, pro Zustand neu eingefärbt
Icons verwenden currentColor und erhalten ihre Zustände (Hover, Ausgewählt, Deaktiviert) durch CSS-Farbe und -Deckkraft, niemals durch separate Assets. Die Umrissvariante ist der Standard; die Füllvariante kennzeichnet den aktiven Zustand.
15. Bewegungszurückhaltung
Keine benutzerdefinierte Animation bei hochfrequenten Interaktionen: Die Aufmerksamkeitskosten wiederholen sich bei jedem Auslöser. Bewegung ist niemals der einzige Rückmeldungskanal; jede animierte Zustandsänderung benötigt auch einen statischen Hinweis (Farbe, Icon, Beschriftung).
Häufige Fehler
| Fehler | Korrektur |
|---|---|
| Gleicher Rahmenradius bei eng verschachtelten Eltern und Kindern | Berechne Außenradius = Innenradius + Abstand |
| Icons sehen außermittig aus | Optisch mit Abstand oder direktem Fix des SVGs anpassen |
| Rahmen nur zur Vortäuschung von Höhe verwendet | Verwende geschichtetes box-shadow mit Transparenz; behalte strukturelle und zustandsbezogene Rahmen |
| Ruckartiger inszenierter Eingang oder kontextbezogener Ausgang | Staffele seltene Eingänge und halte kontexterhaltende Ausgänge subtil |
| Zustandsbasiertes Icon oder Toggle animiert seinen Standardzustand beim Seitenaufbau | Füge initial={false} zu diesem AnimatePresence hinzu; behalte beabsichtigte Seiteneingänge bei |
transition: all auf Elementen | Gib genaue Eigenschaften an |
| Ruckeln der Animation im ersten Frame | Füge will-change: transform (sparsam) hinzu |
| Haarfeines Icon neben fettem Text | Passe die Strichbreite an das Textgewicht an |
| Separate Icon-Assets pro Zustand | Ein currentColor SVG, Zustände via CSS |
| Gefüllte Icons überall | Umriss als Standard, Füllung nur für den aktiven Zustand |
| Eingangssanimation bei jedem Hover oder Tastendruck | Sofortiges Feedback oder ≤150ms Deckkraft-/Farbübergang |
Ausgabeformat der Überprüfung
Verwende dieses Format nur, wenn der Benutzer eine eigenständige UI-Politur-Überprüfung anfordert. Wenn better-interface die Überprüfung orchestriert, gib diesem Skill domänenspezifische Beweise und Erkenntnisse und lasse seinem Ausgabeformat, seiner Schweregradskala, seinen Konsolidierungsregeln, seiner Obergrenze und seinem Urteil den Vorrang.
Präsentiere die eigenständige Überprüfung in zwei Teilen.
Erkenntnisse
Gruppiere alle bestätigten Erkenntnisse nach Prinzip. Verwende eine Markdown-Tabelle mit den Spalten Schweregrad, Ort, Vorher, Nachher und Warum. Verwende niemals separate „Vorher:“ / „Nachher:“-Zeilen.
- Schweregrad:
HOCHmacht eine Interaktion irreführend, nicht reagierend oder wiederholt störend;MITTELschafft ein merkliches handwerkliches oder konsistentes Problem;NIEDRIGist isolierte Politur. - Ort: zitiere
Pfad/zur/Datei:Zeile. Wenn das Artefakt keine Quelldateien hat, nenne stattdessen den genauen Bildschirm und die Komponente. - Vorher / Nachher: Zeige die aktuelle Implementierung und eine umsetzbare Korrektur.
- Warum: Nenne das verletzte Prinzip und erkläre, wie es das Interface beeinflusst.
Fasse ein wiederholtes systemisches Problem in einer Zeile zusammen und liste jeden betroffenen Ort auf. Lasse Prinzipien ohne Erkenntnisse weg.
Beispiel
Konzentrischer Rahmenradius
| Schweregrad | Ort | Vorher | Nachher | Warum |
|---|---|---|---|---|
| NIEDRIG | src/Card.tsx:28 | rounded-xl auf Karte + rounded-xl auf innerem Button (p-2) | rounded-2xl auf Karte (8 + 8 = 16), rounded-lg auf innerem Button | Verschachtelte Ecken sollten konzentrisch sein |
| NIEDRIG | src/card.css:11 | border-radius: 16px auf beiden verschachtelten Oberflächen | Außen 24px, innen 16px mit 8px Abstand | Gleiche verschachtelte Radien lassen die innere Oberfläche gequetscht wirken |
Skalierung beim Drücken
| Schweregrad | Ort | Vorher | Nachher | Warum |
|---|---|---|---|---|
| NIEDRIG | src/Button.tsx:19 | <button className="..."> | Füge active:scale-[0.96] transition-transform hinzu | Druckrückmeldung lässt das Bedienelement reaktionsschnell wirken |
| MITTEL | src/button.css:24 | scale(0.9) beim Drücken | Erhöhe auf scale(0.96) | Alles unter 0.95 wirkt übertrieben |
Überprüfung und Urteil
Nach den Erkenntnissen:
- Überprüfung: Liste die exakt durchgeführten Kontrollen und ihre beobachteten Ergebnisse auf. Gehe jeden relevanten Zustand durch und inspiziere Bewegungen bei 10% Geschwindigkeit, wenn Animationen involviert sind. Wenn eine Kontrolle nicht durchgeführt wurde, teile mit, was noch überprüft werden muss.
- Urteil:
Blockierung, wenn noch einHOCH-Erkenntnis vorhanden ist,Benötigt Änderungen, wenn nurMITTEL- oderNIEDRIG-Erkenntnisse vorhanden sind, undGenehmigtnur, wenn keine umsetzbaren Erkenntnisse mehr vorhanden sind.
Wenn es keine Erkenntnisse gibt, lasse die Tabellen weg, gebe an: „Keine umsetzbaren UI-Politur-Erkenntnisse“, berichte über die Überprüfung und beende mit Genehmigt.