Communitygithub.com

coastdigitalgroup/coastai-skills

Ein systematischer Rahmen für die Gestaltung von Schaltflächen und interaktiven Triggern, der visuelle Hierarchien, Variantenlogik und Aktionsgruppierung verwaltet, um klare Absichten und barrierefreie Interaktionen sicherzustellen.

Was ist coastai-skills?

Dieses Skill definiert ein umfassendes Framework für die Gestaltung von Schaltflächen und Aktionssystemen, das Designer und Entwickler dabei unterstützt, eine konsistente, barrierefreie und benutzerfreundliche Interaktionsbasis zu schaffen. Es behandelt die Hierarchie (Primär, Sekundär, Tertiär, Gefahr), die Größenanpassung (Groß, Mittel, Klein), die innere Anatomie (Abstände, Symbole, Eckenradius) und die Gruppierung von Aktionen. Das Skill ist plattformunabhängig und kann in Designsystemen, Komponentenbibliotheken oder direkt im Code eingesetzt werden, um Button-Varianten, Größen und Verhalten zu standardisieren. Es enthält Entscheidungsregeln wie die „Ein-Primär-Button-Regel“, Richtlinien zur Positionierung von Symbolen, Anforderungen an Barrierefreiheit (WCAG AA Kontrast, Mindestgröße 24×24 px) sowie Warnungen vor typischen Fehlern wie „Button-Suppe“ oder fehlenden Interaktionszuständen. Die Validierungskriterien helfen Teams, die Umsetzung systematisch zu prüfen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Button- und Aktionssystem

Zweck

Das Button- und Aktionssystem bietet eine Methodik zur Gestaltung der primären Treiber der Benutzerinteraktion. Buttons sind das grundlegende Bindeglied zwischen der Absicht eines Benutzers und der Reaktion eines Systems. Dieses System stellt sicher, dass jede Aktion visuell priorisiert (Hierarchie), konsistent gestaltet (Kohäsion) und auf allen Geräten einfach zu bedienen ist (Benutzerfreundlichkeit). Es geht über das „Erstellen eines Buttons“ hinaus und definiert einen logischen Rahmen dafür, wie verschiedene Aktionstypen innerhalb eines Layouts miteinander in Beziehung stehen.

Anwendungsfälle

  • Definieren einer Button-Komponentenbibliothek für ein Designsystem.
  • Etablieren einer Hierarchie von Aktionen in einem Hero-Bereich oder Seitenkopf.
  • Organisieren von Gruppen verwandter Aktionen (z. B. Speichern, Abbrechen, Löschen).
  • Entwerfen spezieller Auslöser wie reine Symbole oder Floating Action Buttons (FABs).
  • Standardisieren der Beziehung zwischen Button-Größen und Layout-Dichte.

Wann NICHT zu verwenden

  • Globale Navigationslinks: Für die Navigation zwischen Hauptseitenbereichen das site-navigation-system verwenden.
  • Hyperlinks im Text: Für Links, die in einen Absatz eingebettet sind und zu weiteren Informationen führen, die standardmäßigen Typografiebehandlungen verwenden.
  • Rein dekorative Elemente: Button-Stile nicht für Elemente verwenden, die nicht angeklickt oder angetippt werden können.
  • Komplexe Formulareingaben: Für die Auswahl von Optionen (Checkboxen, Radios, Selects) das form-design-system verwenden.

Eingaben

  1. Aktionspriorität: Ist die Aufgabe Primär (Stufe 1), Sekundär (Stufe 2) oder Tertiär (Stufe 3)?
  2. Aktionsgewichtung: Ist die Aktion „Positiv“ (Absenden), „Neutral“ (Abbrechen) oder „Destruktiv“ (Löschen)?
  3. Kontextuelle Dichte: Wo lebt der Button? (z. B. in einem großzügigen Hero vs. einer kompakten Datentabellenzeile).
  4. Marken-Tokens: Farbpalette, Typografie-Skala und bevorzugte Eckenradien.

Ausgaben

  1. Button-Varianten-Matrix: Definierte Stile für Primär, Sekundär, Ghost und Gefahr.
  2. Größenskala: Eine Reihe von Höhen und Abständen (z. B. Klein, Mittel, Groß).
  3. Anatomie-Spezifikation: Interne Abstandsregeln für Text, Symbole und Container.
  4. Aktionsgruppierungsregeln: Richtlinien für Ausrichtung, Reihenfolge und Abstände zwischen mehreren Buttons.

Arbeitsablauf

1. Die Varianten-Hierarchie festlegen

Weisen Sie Buttons visuelle Gewichte basierend auf ihrer Bedeutung für das Benutzerziel zu:

  • Primär (Stufe 1): Hoher Kontrast, gefüllter Hintergrund. Normalerweise das „Hauptziel“ der Seite. Nur einer pro Ansicht.
  • Sekundär (Stufe 2): Umriss oder niedriger Kontrast-Hintergrund. Für alternative oder unterstützende Aktionen.
  • Tertiär/Ghost (Stufe 3): Kein Hintergrund oder Rahmen im Standardzustand. Für Aufgaben mit niedriger Priorität oder in dichten Benutzeroberflächen (wie Tabellen).
  • Gefahr: Hoher Kontrast (normalerweise Rot). Streng für destruktive, dauerhafte Aktionen.

2. Die Größenskala definieren

Ordnen Sie Button-Abmessungen dem Layout-Kontext zu, indem Sie das fluid-spacing-system verwenden:

  • Groß (Hero/Landing): Maximales Hervorheben. Hoher vertikaler Abstand.
  • Mittel (Standard): Der Standard für Formulare, Modals und Kopfzeilen.
  • Klein (Kompakt): Verwendet in Seitenleisten, Karten und Datentabellen, wo Platz knapp ist.

3. Die innere Anatomie entwerfen

Standardisieren Sie die Struktur des Button-Containers:

  • Abstand: Ein konsistentes Verhältnis von horizontalem zu vertikalem Abstand einhalten (normalerweise horizontal = 1,5x bis 2x vertikal).
  • Symbolintegration: Den Abstand zwischen einem Symbol und Text definieren (z. B. --space-xs).
  • Eckenradius: Die „Rundheit“ (Scharf, Abgerundet oder Pille) bestimmen, um den visuellen Ton der Marke zu treffen.

4. Button-Gruppen erstellen

Wenn mehrere Aktionen zusammen platziert werden, einer logischen Reihenfolge folgen:

  • Reihenfolge: Die primäre Aktion in der „Abschluss“-Position platzieren (Rechts auf Desktop, Oben in einem vertikalen Mobil-Stapel).
  • Abstand: Einen konsistenten Abstand (z. B. --space-s) zwischen Buttons in einer Gruppe verwenden.
  • Ausrichtung: Aktionen in Modals/Kopfzeilen rechtsbündig; in Formularen linksbündig; in Heros zentriert.

5. Responsives Verhalten definieren

Sicherstellen, dass Aktionen auf allen Viewports nutzbar bleiben:

  • Vollbreite (Block) Buttons: Auf Mobilgeräten werden kleine Buttons oft auf die volle Breite des Containers ausgedehnt, um die Daumenreichweite zu verbessern.
  • Nur-Symbol-Fallback: In extrem engen Kopfzeilen können Textlabels zugunsten von Symbolen ausgeblendet werden (sicherstellen, dass ein aria-label vorhanden ist).

Entscheidungsregeln

  • Die „Ein Primär-Button“-Regel: In jedem einzelnen Viewport/Kontext sollte nur ein Primär-Button (Stufe 1) sichtbar sein, um eine „Auswahlparalyse“ zu vermeiden.
  • Ghost vs. Link: Einen Ghost-Button verwenden, wenn die Aktion funktional ist (z. B. „Schließen“, „Abbrechen“); einen Textlink verwenden, wenn die Aktion navigational ist (z. B. „Mehr zu unserer Richtlinie erfahren“).
  • Symbolplatzierung: Ein führendes Symbol (Links) verwenden, um die Aktion zu verdeutlichen (z. B. ein Suchsymbol); ein nachgestelltes Symbol (Rechts) verwenden, um eine Richtung anzuzeigen (z. B. ein Pfeil für „Nächster Schritt“).
  • Kontrast für Gefahr: Destruktive Buttons müssen sich deutlich von primären Buttons unterscheiden, um versehentliche Klicks zu verhindern.

Einschränkungen

  • Barrierefreiheit: Text muss WCAG-AA-Kontrast (4,5:1) erfüllen. Interaktive Elemente müssen einen klaren focus-Zustand haben (siehe interactive-state-system).
  • Berührungsziele: Alle Buttons müssen eine minimale interaktive Fläche von 24×24 px (WCAG 2.2 SC 2.5.8) haben, auch wenn das visuelle Element kleiner ist; 44×44 px als komfortables Standardmaß für primäre Aktionen und mobile Layouts verwenden.
  • Textkürzung: Button-Text sollte niemals abgeschnitten werden. Wenn das Label zu lang ist, den Text überarbeiten oder den Button umbrechen/erweitern lassen.

Häufige Fehlermuster

  • Button-Suppe: 3–4 Primär-Buttons auf einer Seite zu verwenden, die die Bedeutung des Haupt-CTAs verwässern.
  • Die „Grauzone“: Buttons wie deaktivierte Elemente aussehen lassen, weil ihnen ausreichend Kontrast oder Farbe fehlt.
  • Fehlende Interaktion: Keine hover- oder active-Zustände zu definieren, sodass der Benutzer unsicher ist, ob sein Klick registriert wurde.
  • Winzige Ziele: Kleine, reine Text-Ghost-Buttons zu entwerfen, die auf einem mobilen Bildschirm kaum zu treffen sind.
  • Verwirrende Ausrichtung: Unterschiedliche Button-Ausrichtungen im selben Ablauf zu mischen, sodass der Benutzer nach der nächsten Aktion „suchen“ muss.

Validierungskriterien

  • Jede Seite/jeder Viewport hat eine klare primäre Aktion.
  • Button-Varianten (Primär, Sekundär, Ghost, Gefahr) werden konsistent verwendet.
  • Buttons erfüllen das WCAG-2.2-Mindestberührungsziel von 24×24 px (2.5.8), wobei 44×44 px für primäre und mobile Aktionen verwendet wird.
  • Die visuelle Hierarchie bleibt erhalten, wenn Buttons gruppiert werden.
  • Fokus-Zustände sind deutlich und kontrastreich.
  • Button-Labels sind prägnant und verwenden „Aktionsverben“ (z. B. „Speichern“, „Erstellen“, „Beitreten“).
  • Auf mobilen Viewports werden bei Bedarf vollbreite Buttons verwendet, um die Erreichbarkeit zu verbessern.

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 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 specify a systematic dark theme framework, establishing rules for elevation-based surface colors, desaturated brand accents, text legibility, and media adaptation to ensure an accessible, low-fatigue experience.

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