UI-Design: Regeln für die Erstellung von Oberflächen
Diese Regeln basieren auf UI Design Principles von Michael Filipiuk (Ausgabe 2021). Diese Datei enthält die Regeln, die für jeden Bildschirm gelten. references/ (neben dieser Datei) enthält die Details, eine Datei pro Thema; lies nur die Dateien, die deine Aufgabe berührt.
Regeln ohne Tag stammen aus dem Buch. (WCAG) kennzeichnet einen Barrierefreiheitsstandard, den das Buch nicht nennt. (convention) kennzeichnet einen allgemeinen Industriestandard, der eine Lücke füllt. (derived) kennzeichnet einen Wert, der mit der Methode des Buches berechnet wurde. 1 pt im Buch = 1 CSS px = 1 iOS pt = 1 Android dp.
Das Designsystem des Repos hat Vorrang
Wenn das Repo bereits Tokens oder ein Theme hat (eine Tailwind-Konfiguration, CSS-Variablen, ein shadcn/MUI-Theme, eine components/ui/-Bibliothek), verwende diese. Dieser Skill füllt nur das, was sie nicht definieren.
- Führe niemals einen zweiten Satz von Tokens neben den eigenen des Repos ein.
- Verwende eine vorhandene Komponente wieder, anstatt eine parallele zu bauen.
- Wenn das Repo selbst eine der folgenden Regeln bricht (einen fehlgeschlagenen Kontrast, einen 32-Pixel-Button), behalte den Wert des Repos bei und melde den Konflikt. Überschreibe ihn nicht stillschweigend.
Priorität bei Regelkonflikten: Benutzerfreundlichkeit > Barrierefreiheit > Konsistenz > Einfachheit > Aussehen.
Schneller Einstieg
- Persönlichkeit zuerst: verspielt, neutral oder ernst, basierend auf der Marke und der Zielgruppe (
references/personality-and-copy.md). Nie den eigenen Geschmack. - Tokens vor Bildschirmen: Farben, Schriftgrößenskala und Abstandsskala, aus dem Repo oder
references/tokens.md. Nichts außerhalb dieser verwenden. - Graustufen zuerst: Hierarchie, Layout und Abstände korrekt einstellen, dann Farbe nur dort hinzufügen, wo sie eine Aufgabe hat.
- Komponenten mit jedem Zustand (Standard, Hover, Gedrückt, Fokus, Deaktiviert, Fehler, Erfolg) und jeder Bildschirmzustand (Leer, Ladezustand, Fehler, 404).
- Vor dem Melden als erledigt: gehe
references/checklist.mdfür das durch, was du gebaut hast. Wenn du einen Screenshot machen kannst, überprüfe den Screenshot, nicht den Code.
Unverhandelbar
- Abstände folgen der Skala. Verwende eine 4-Punkt-Skala auf Mobilgeräten und eine 8-Punkt-Skala im Web. Keine 5, 13 oder 22 Pixel Werte.
- Fließtext ist 16–17 px. Gehe für keinen Text unter 10 px und bevorzuge 12 px oder mehr. Verwende niemals eine Light-Schriftstärke für kleinen Text.
- Eine Schriftart, standardmäßig eine serifenlose. Verwende etwa 5 Größen.
- Verwende niemals
#000000für Text oder Schatten. Verwende ein dunkles getöntes Grau wie#1F1F1F. - Eine Primärfarbe, die nur auf das angewendet wird, was hervorstechen muss. Wenn alles hervorsticht, sticht nichts hervor.
- Kontrast: 4,5:1 für Fließtext und 3:1 für großen Text und UI-Elemente (WCAG).
- Verwende niemals Farbe allein, um Bedeutung zu vermitteln. Fehler-, Erfolgsmeldungen und Links erhalten auch ein Icon, Text, eine Schriftstärke oder eine Unterstreichung.
- Jedes Antipp- oder Klickziel ist mindestens 44×44, auch wenn das sichtbare Symbol kleiner ist.
- Buttons sind 40–60 px hoch, mit einem primären Button pro Gruppe. Wenn Buttons paarweise auftreten, steht der primäre rechts. Die Bezeichnung sagt genau, was passiert.
- Eingabefelder haben immer ein sichtbares Label. Ein Platzhalter allein ist kein Label. Verwende ein einspaltiges Formular mit Inline-Validierung und lösche niemals die Eingabe des Benutzers.
- Schatten sind weich (großer Y-Versatz, große Unschärfe, 5–10 % Deckkraft) und nur für interaktive oder hervorgehobene Elemente.
- Icons stammen aus einem Pack, in einem Stil, mit derselben Strichstärke und Rundung. Icons, die nicht allgemein bekannt sind, erhalten ein Label.
- Animationen geben Feedback, dauern unter 1000 ms und sind erleichtert (niemals linear).
- Kein Lorem Ipsum. Schreibe echte, kurze, menschliche Texte. Fehlermeldungen sagen, wie das Problem behoben wird. Dialoge nennen das Objekt und die Konsequenz.
- Gleiches Ding, gleiches Aussehen, gleiches Verhalten auf allen Bildschirmen. Folge den Plattformmustern für das Verhalten.
Welche Referenz zu lesen ist
| Die Aufgabe berührt | Lies |
|---|---|
| Ein neues Projekt oder Theme, Werte auswählen | tokens.md (Abstände, Schriftgrößenskala, Farbrollen, Radius, Schatten, Bewegung, Starter-CSS) |
| Ein Seiten- oder Bildschirmlayout, Raster, Abstände, Hierarchie | layout.md |
| Textstile, Überschriften, Absätze | typography.md |
| Palette, Dunkelmodus, Schatten, Farbverläufe | color-and-depth.md |
| Buttons und Handlungsaufforderungen | buttons.md |
| Formulare, Eingabefelder, Auswahlfelder, Kontrollkästchen, Validierung | forms.md |
| Karten, Listen von Elementen | cards.md |
| Icons | icons.md |
| Tab-Leiste, obere Navigation, Seitenleiste, Links | navigation.md |
| Fotos, Illustrationen, Leerzustands- und 404-Grafiken | imagery.md |
| Markengefühl, Button-Beschriftungen, Dialoge, Fehler, Ton | personality-and-copy.md |
| Übergänge, Hover, Ladezustand, Feedback | motion.md |
| Kontrast, Alternativtexte, Ziele, Bildunterschriften | accessibility.md |
| Wiederzuverwendende Komponenten, Zustände, leere/404-Bildschirme, ein Designsystem | system-and-states.md |
| Überprüfung eines fertigen Bildschirms | checklist.md |
Alle Pfade befinden sich im references/-Ordner dieses Skills.