Was macht Frontend?
Standards für Browser-UI, die von echten Menschen mit Tastaturen, Screenreadern, langsamen Telefonen und Druckern verwendet werden. Die folgenden Regeln sind diejenigen, die übersprungen werden, wenn eine UI „fertig aussieht“.
Regeln, die am wichtigsten sind
- Verwende das Element, das die Sache bedeutet.
<button>für Aktionen,<a href>für Navigation,<label>für jedes Feld,<table>für tabellarische Daten. Ein<div>mit einem Click-Handler ist nicht fokussierbar, hat keine Rolle und ist für assistive Technologien unsichtbar. ARIA schließt lediglich Lücken, die ein natives Element nicht füllen kann. - Jede asynchrone Ansicht hat vier Zustände: Laden, Fehler, leer und Daten. Schreibe alle vier, bevor du die Ansicht als fertig bezeichnest. Ein leerer Bereich ist ein Fehler.
- Erfinde niemals Daten. Ein fehlender Zeitraum ist eine Lücke oder ein „Keine Daten“-Label, niemals Null und niemals eine interpolierte Linie. Prognosen sind immer sichtbar von Ist-Werten unterscheidbar.
- Signalisere niemals nur durch Farbe. Jeder farblich codierte Status trägt auch Text oder ein Symbol mit einem zugänglichen Namen. Ein Graustufendruck und farbenblinde Leser erhalten sonst nichts.
- Gemeinsam nutzbarer Zustand lebt in der URL. Filter, Tabs, Suchbegriffe, ausgewählte IDs. Zurück, Aktualisieren und Teilen müssen diesen erhalten. Flüchtiger Zustand (Hover, ein offener Tooltip) gehört nicht in die URL.
- Ein Wert, der aus mehreren Zustandsteilen abgeleitet wird, erhält eine Funktion, die immer dann aufgerufen wird, wenn sich einer von ihnen ändert. Berechne ihn niemals innerhalb des Callbacks, das zu einem von ihnen gehört. Beispiel: Ein aus einem Grenzwert und einem Gruppenfilter erstellter Download-Link wurde nur im Fetch-Callback des Grenzwerts neu erstellt, so dass nach einer Filteränderung der Export stillschweigend auf die gesamte Liste zeigte.
- Reflow ab 320 CSS px. Kein horizontaler Seiten-Scroll, kein abgeschnittenes Inhalte, Text auf 200 % vergrößerbar. Teste sowohl mit einer Telefonbreite als auch mit der Desktop-Breite, für die du entworfen hast.
- Passe die Werkzeuge an den Bedarf an. Folge in einem bestehenden Repository dem bereits vorhandenen Framework und Build. Erwäge für eine kleine neue Seite oder ein internes Tool einfaches HTML, CSS und etwas JavaScript, bevor du eine Build-Pipeline hinzufügst; greife zu einem Framework, wenn der Zustand es wirklich erfordert.
Wann nicht zu verwenden
- Wahl einer visuellen Richtung, Typografie oder Palette: die Fähigkeiten
designerundvisual-design. - Native iOS-, Android- oder React-Native-Apps: die Fähigkeit
mobile(undswiftfür Swift-Code). - API-Form und Server-Endpunkte: die Fähigkeiten
api-designundbackend-patterns. - Testtechnik im Detail: die Fähigkeiten
tddundtesting-strategy.
Wo der Zustand lebt
Entscheide vor dem Schreiben des Zustands einer Komponente. Beginne lokal und eskalierte nur aus einem genannten Grund.
| Zustand | Zuhause | Beispiel |
|---|---|---|
| Lokale UI | Komponenten-Zustand | Modal offen, Input-Entwurf, Hover |
| Von Geschwistern geteilt | Nächstgelegener gemeinsamer Elternteil | Aktiver Tab, der von zwei Panels gelesen wird |
| Serverdaten | Eine Server-Cache-Bibliothek (TanStack Query, SWR) oder der Loader des Frameworks | API-Antworten, Paginierung, erneutes Abrufen |
| App-weiter Client-Zustand | Ein kleiner Store, nur wenn nötig | Angemeldeter Benutzer, Benachrichtigungswarteschlange |
| Teilbarer Ansichts-Zustand | URL-Abfrage oder Route | Filter, Suche, ausgewählte ID |
| Überlebt Neuladen, pro Gerät | localStorage | Einstellungen, ungesendete Entwürfe |
Eskaliere nur, wenn: zwei nicht verwandte Komponenten denselben Zustand benötigen (hebe sie an oder verwende den Server-Cache); der Zustand ein Neuladen überleben muss (URL oder Speicher); die Daten von einem Server stammen (Server-Cache, kein globaler Store). In einen globalen Store kopierte Serverdaten werden veraltet und duplizieren Lade- und Fehlerlogik.
Diagramme, Druck und vereinfachte Ansichten
- Diagramme: eine Farbskala, die von Frontend und Backend gemeinsam genutzt wird, ein expliziter leerer Zustand, ehrliche Lücken, eine HTML-Legende. Lese
references/charts.md, bevor du ein Diagramm erstellst oder änderst. - Druck oder PDF: lese
references/print.md, bevor du eine druckbare Ansicht erstellst. Canvas-Elemente drucken ohne den darin beschriebenen Erfassungsschritt nicht zuverlässig. - Vereinfachte oder schreibgeschützte Ansichten für nicht-technische Leser: keine Bearbeitungssteuerelemente, großzügige Text- und Zielgrößen, Status als Farbe und Text, in einfacher Sprache verfasste Zusammenfassungen, die aus den Daten berechnet werden, wenige Bildschirme und Übersichtszahlen mit kurzen Sätzen anstelle von rohen Tabellen.
Performance
Behebe in der Reihenfolge der Auswirkungen zuerst: Request-Wasserfälle, dann ausgeliefertes JavaScript, dann Server-Antwortzeit, dann Hauptthread-Arbeit während der Interaktion und zuletzt Mikrooptimierungen. Ziele: LCP 2,5s oder weniger, INP 200ms oder weniger, CLS 0,1 oder weniger beim 75. Perzentil der realen Besuche. Lese references/performance.md, wenn eine Seite langsam ist, bevor du eine schwere Abhängigkeit hinzufügst oder vor einem Start mit Performance-Zielen.
Fallstricke
- Render-Pfade sind heiße Schleifen. Ein Komponenten-Body oder ein berechneter Getter wird bei jedem Hover und jeder nicht verwandten Zustandsänderung ausgeführt. Schwere Ableitungen dort hungern den Hauptthread aus, und das erste Symptom kann ein flackernder Test an anderer Stelle sein. Dedupliziere, dann memoisiere auf den vorgelagerten Eingaben.
- Eine nicht deklarierte CSS-Custom-Property schlägt stillschweigend fehl.
var(--mono), wenn der Token--font-monoist, macht die Deklaration zum Zeitpunkt der berechneten Wert ungültig: Die Eigenschaft wird vererbt, ohne Fehler. In einer Kurzschreibweise (font: 400 10px/1 var(--mono)) gehen auch die Größe und die Zeilenhöhe verloren. Gibvar()einen Fallback-Wert oder überprüfe deklarierte Tokens gegen referenzierte über das erstellte Stylesheet. - Die Höhe eines Diagramms gehört auf seinen Wrapper. Eine Höhe auf dem
canvasbekämpft die Größenanpassungslogik der Bibliothek, und das Diagramm wächst bei jeder Größenänderung. - Fokus ist deine Aufgabe bei benutzerdefinierten Widgets. Das Öffnen eines Dialogs verschiebt den Fokus hinein; das Schließen gibt den Fokus zum Auslöser zurück; Escape schließt. Bevorzuge das native
<dialog>-Element. Der Wiederaufbau von Markup mitinnerHTMLverliert den Fokus. outline: noneohne Ersatz entfernt das einzige Signal, das Tastaturbenutzer haben. Verwende stattdessen:focus-visible, um es zu gestalten.- Symbold-Only-Buttons brauchen einen Namen (
aria-labeloder visuell versteckten Text). - Inhalte, die erst nach einem Client-Fetch existieren, sind auf schwachen Geräten langsam, leer, wenn JavaScript fehlschlägt, und schwächer für Crawler. Rendere sinnvolle Inhalte auf dem Server, wo der Stack dies zulässt.
- Nicht dimensionierte Medien verschieben das Layout. Setze
widthundheight(oderaspect-ratio) auf Bilder, Videos und Einbettungen. Lade das Bild, das das größte oberhalb des Falzes ist, niemals lazy. - Handgebaute Dropdowns, Tabs und Slider benötigen das vollständige Tastaturmodell aus den WAI-ARIA Authoring Practices. Ein natives Element ist fast immer günstiger.
- Ein handgeschriebener Fake-DOM kann Tests inert machen. Wenn der Fake pro Lookup ein frisches Objekt zurückgibt, geht jede Eigenschaft, die darauf geschrieben wird (
href,disabled,value), verloren, und keine Zusicherung darauf kann fehlschlagen. Mache die Funktion rückgängig und verlange, dass der Test fehlschlägt, bevor du ihr vertraust. - Eine gepinnte CDN-Version, niemals eine ungepinnte. Ein ungepinntes Skript ändert sich ohne Commit unter deinen Händen.
Verifikation
Beweise es mit dem, was das Projekt bereits hat (sein Test-Runner, Linter, Typ-Prüfer, Barrierefreiheitswerkzeuge), bevor du neue Werkzeuge hinzufügst.
- Tests, Lint und Typprüfung bestehen. Jeder neue Test wurde gesehen, wie er mit der rückgängig gemachten Funktion fehlschlug.
- Die Seite wurde gerendert und betrachtet, bei einer Telefonbreite und einer Desktop-Breite. Gib den Prüfern nach Möglichkeit sowohl eine Live-Vorschau als auch Screenshots.
- Nur Tastatur: jedes Steuerelement erreichbar, bedienbar und sichtbar fokussiert; Reihenfolge stimmt mit der visuellen Reihenfolge überein; keine Falle.
- Ein automatisierter Barrierefreiheits-Audit (axe, Lighthouse oder das Werkzeug des Projekts) hat keine neuen Verstöße. Kontrast mit einem Werkzeug geprüft: 4,5:1 für Fließtext, 3:1 für großen Text und UI-Komponenten-Ränder (WCAG AA).
- Lade-, Fehler-, Leer- und Datenzustände wurden jeweils gezeigt, indem jeder Zustand erzwungen wurde.
- Teilbarer Zustand überlebt Aktualisieren und Zurück.
- Konsole hat Null Fehler und Null Warnungen beim Laden und während der Nutzung.
- Performance-Budget überprüft, wenn die Änderung eine Abhängigkeit hinzufügt oder eine schwere Ansicht betrifft (Bundle-Analyzer, ein gedrosseltes Profil).
- Druckvorschau überprüft, wenn die Seite druckbar ist.
Für eine Überprüfung: Berichte die Ergebnisse pro Datei mit der verletzten Regel und der Korrektur, das Schlimmste zuerst.