Communitygithub.com

Formular-Design-System

Entwerfen und dokumentieren Sie ein systematisches Framework für Formularschnittstellen, das Anatomie, räumliche Anordnung und visuelle Affordanzen definiert, um Konsistenz, Benutzerfreundlichkeit und Barrierefreiheit sicherzustellen.

Was ist Formular-Design-System?

Die Fähigkeit "Formular-Design-System" bietet eine umfassende Methodik zur Gestaltung des visuellen und räumlichen Rahmens von Webformularen. Sie definiert, WAS und WO Formularelemente wie Labels, Eingabefelder, Auswahlmöglichkeiten und Aktionen organisiert werden, um eine vorhersagbare, zugängliche und vertrauenswürdige Benutzeroberfläche zu schaffen, die kognitive Belastung reduziert und Benutzerfehler verhindert. Diese Fähigkeit unterstützt Entwickler und Designer bei der Erstellung von UI-Kits, der Etablierung visueller Standards für komplexe mehrstufige Dateneingabeschnittstellen, der Prüfung bestehender Formulare auf Inkonsistenzen und dem Entwurf responsiver Formularlayouts. Sie liefert konkrete Outputs wie eine Spezifikation der Eingabeanatomie, einen Layout-Blueprint, eine Komponenten-Zuordnung für Auswahlelemente und eine Matrix für Feedback- und Zustandsvisualisierungen. Die Entscheidungsregeln betonen eine einzelspaltige Anordnung, oben ausgerichtete Labels und eine klare visuelle Hierarchie, während die Einschränkungen die Einhaltung der WCAG-Richtlinien für Barrierefreiheit sicherstellen. Die Fähigkeit ist ideal für die Arbeit mit Claude Code und anderen KI-Agenten, die konsistente und benutzerzentrierte Formulardesigns erstellen müssen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/form-design-system

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Formular-Design-System?

Zweck

Die Fähigkeit "Formular-Design-System" bietet eine Methodik zur Gestaltung des visuellen und räumlichen Rahmens von Webformularen. Während die technische Implementierung das "Wie" behandelt und die Optimierung des Wachstums das "Warum", definiert das Designsystem das "Was" und "Wo". Es stellt sicher, dass Formularelemente – Labels, Eingabefelder, Auswahlmöglichkeiten und Aktionen – in einer vorhersagbaren, zugänglichen und vertrauenswürdigen Oberfläche organisiert sind, die die kognitive Belastung reduziert und Benutzerfehler verhindert.

Anwendungsfälle

  • Entwerfen einer UI-Kit- oder Designsystem-Komponentenbibliothek für Formulare.
  • Festlegen visueller Standards für komplexe, mehrstufige Dateneingabeschnittstellen.
  • Überprüfung bestehender Formulare auf visuelle Inkonsistenzen oder räumliche Reibungen.
  • Entwerfen responsiver Formularlayouts, die die Hierarchie über Geräte hinweg beibehalten.
  • Standardisieren von Fehler- und Validierungsvisualisierungsmustern.

Wann NICHT zu verwenden

  • Allgemeine Suchleisten: Einfache, einzelne Suchfelder benötigen selten die volle Behandlung des Designsystems.
  • Experimentelle interaktive Medien: Bei denen die formularähnliche Interaktion sekundär zu einer narrativen oder künstlerischen Erfahrung ist.
  • Low-Stakes-Mikrointeraktionen: Wie ein "Daumen hoch/Daumen runter" oder ein einfacher Schalter ohne begleitende Dateneingabe.

Eingaben

  1. Informationsanatomie: Die spezifischen zu erfassenden Datenpunkte und ihre Beziehungen.
  2. Geräte-Breakpoints: Responsive Anforderungen aus dem responsive-grid-system.
  3. Markenstile: Typografieskalen, Farbschemata und Abstands-Tokens (aus dem fluid-spacing-system).
  4. Interaktionsanforderungen: Ob das Formular Echtzeitvalidierung, Datei-Uploads oder komplexe Auswahlmöglichkeiten erfordert.

Ausgaben

  1. Spezifikation der Eingabeanatomie: Visuelle Definitionen für Labels, Eingabefelder, Hilfetexte, Symbole und Fehlermeldungen.
  2. Layout-Blueprint: Räumliche Regeln für Feldgruppierung, Ausrichtung (oben vs. links) und Aktionsplatzierung.
  3. Zuordnung der Auswahlkomponenten: Definitionen, wann Radio, Checkbox, Switch oder Select verwendet werden.
  4. Feedback- und Zustandsmatrix: Visuelle Behandlungen für Hover-, Fokus-, Deaktiviert-, Erfolgs- und Fehlerzustände.

Arbeitsablauf

1. Komponentenanatomie definieren

Etablieren Sie eine konsistente Struktur für jede "Feldgruppe". Ein Feld sollte bestehen aus:

  • Das Label: Klarer, prägnanter Text, der das Feld identifiziert.
  • Die Eingabe: Der interaktive Container (Text, Select usw.).
  • Hilfe-/Anleitungstext: Dauerhafte Anleitung (z. B. "Passwort muss 8 Zeichen lang sein").
  • Fehlermeldung: Kontextbezogenes Feedback, das nur erscheint, wenn die Validierung fehlschlägt.

2. Räumliches Layout und Ausrichtung festlegen

Bestimmen Sie die Beziehung zwischen Labels und Eingaben:

  • Oben ausgerichtete Labels (empfohlen): Am besten für die Scanbarkeit und mobile Reaktionsfähigkeit.
  • Links ausgerichtete Labels: Nur für datenintensive Desktop-Oberflächen, bei denen vertikaler Platz kritisch ist.
  • Gruppierung: Verwenden Sie logische Abstände (z. B. --space-l) zwischen Gruppen und kleinere Abstände (z. B. --space-s) innerhalb von Gruppen.

3. Interaktionsmuster auswählen

Weisen Sie UI-Muster Datentypen zu:

  • Binäre Entscheidungen: Verwenden Sie Checkboxen für "Ja/Nein" oder Mehrfachauswahl.
  • Gegenseitige Ausschließlichkeit: Verwenden Sie Radio-Buttons für 2–5 Optionen; verwenden Sie Select für 6+ Optionen.
  • Sofortige Schalter: Verwenden Sie Switches für Einstellungen, die ohne eine "Absenden"-Aktion sofort wirksam werden.

4. Die Feedback-Schleife entwerfen

Erstellen Sie eine visuelle Hierarchie für die Validierung:

  • Fokus-Zustand: Verwenden Sie einen kontrastreichen Ring, um das aktive Feld anzuzeigen.
  • Fehlerzustand: Verwenden Sie Farbe (normalerweise Rot), Symbole und Rahmendicke, um Fehler zu signalisieren.
  • Erfolgszustand: Verwenden Sie subtile Hinweise (wie ein grünes Häkchen) für kritische Felder (z. B. Verfügbarkeit des Benutzernamens).

5. Responsive Anpassungen planen

Kartieren Sie, wie das Formular auf kleineren Bildschirmen überlebt:

  • Stapeln: Mehrspaltige Layouts auf dem Desktop müssen auf Mobilgeräten zu einer einzigen Spalte gestapelt werden.
  • Touch-Ziele: Stellen Sie sicher, dass alle interaktiven Zonen (Radios, Checkboxen, Buttons) mindestens 24 x 24 Pixel groß sind (WCAG 2.2 SC 2.5.8 Minimum); 44 x 44 Pixel sind bevorzugt und sollten die Standardgröße für primäre Absendeaktionen sein.

Entscheidungsregeln

  • Die Einzelspaltenregel: Verwenden Sie ein einspaltiges Layout für die Mehrheit der Formulare, um einen klaren vertikalen Scanpfad beizubehalten und die Ermüdung durch Augenbewegungen zu verringern.
  • Label-Ausrichtung: Standardmäßig oben ausgerichtete Labels. Sie reduzieren die Anzahl der Augenfixierungen, die zum Verarbeiten des Formulars erforderlich sind.
  • Platzhalter vs. Labels: Verwenden Sie Platzhalter niemals als Labels. Labels müssen auch dann sichtbar bleiben, wenn der Benutzer mit der Eingabe begonnen hat.
  • Button-Hierarchie: Die primäre "Absenden"-Aktion sollte die optisch auffälligste sein. Sekundäre Aktionen (z. B. "Abbrechen") sollten Textlinks oder kontrastarme Buttons sein.
  • Nähe: Platzieren Sie Hilfetexte und Fehlermeldungen so nah wie möglich an der Eingabe (normalerweise direkt darunter).

Einschränkungen

  • Barrierefreiheit: Labels müssen programmatisch mit Eingaben verknüpft sein (<label for> oder Wrapping). Kontrastverhältnisse für Text und Rahmen müssen WCAG AA erfüllen (4,5:1 für Text, 3:1 für UI-Komponenten). Fehlermeldungen müssen programmatisch mit ihrer Eingabe über aria-describedby verknüpft sein, und ungültige Felder müssen aria-invalid="true" setzen. Fokusindikatoren dürfen nicht hinter klebrigen Kopfzeilen, Toasts oder Overlays verborgen werden (WCAG 2.4.11 Focus Not Obscured).
  • Reaktionsfähigkeit: Formularfelder dürfen niemals ihren Container überlaufen oder feste Breiten haben, die mobile Viewports überschreiten.
  • Visuelle Hierarchie: Fehlermeldungen müssen sich visuell von Hilfetexten unterscheiden, um sicherzustellen, dass sie nicht übersehen werden.

Häufige Fehlermuster

  • Die "Platzhalter-Label"-Falle: Verwenden von Platzhaltern anstelle von Labels, wodurch Benutzer beim Tippen den Kontext verlieren.
  • Überwältigende Spalten: Verwenden von mehrspaltigen Layouts, die den natürlichen vertikalen Scanpfad des Benutzers verwirren.
  • Vage Fehler: Visualisieren eines Fehlers nur mit Farbe (z. B. nur den Rahmen rot färben) ohne Symbol oder Textnachricht.
  • Kleine Touch-Ziele: Entwerfen von Radios oder Checkboxen, die für die Daumeninteraktion auf Mobilgeräten zu klein sind.
  • Der "unsichtbare" Fokus: Keinen klaren Fokusring bereitstellen, was die Navigation für Tastaturbenutzer unmöglich macht.

Validierungskriterien

  • Jede Eingabe hat ein dauerhaftes, sichtbares Label.
  • Das Formular folgt einem logischen, einspaltigen vertikalen Scanpfad.
  • Fehlerzustände verwenden eine Kombination aus Farbe, Symbolen und Text.
  • Fokusindikatoren sind kontrastreich und deutlich sichtbar.
  • Interaktive Elemente (Eingaben, Buttons) erfüllen das WCAG 2.2 24x24 Pixel Touch-Ziel-Minimum (44x44 Pixel bevorzugt).
  • Das Layout geht auf mobilen Viewports nahtlos in eine einzige Spalte über.
  • Primäre, sekundäre und tertiäre Aktionen haben eine klare visuelle Hierarchie.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Verwandte Skills