Communitygithub.com

coastdigitalgroup/coastai-skills

Entwerfen und Implementieren eines systematischen Frameworks für progressive Offenlegung mittels Akkordeons, unter Gewährleistung struktureller Integrität, visueller Hinweise und Barrierefreiheit bei verschiedenen Inhaltsdichten und Geräten.

Was ist coastai-skills?

Diese Skill bietet eine Methodik zur Gestaltung und Strukturierung von Akkordeon-Komponenten – stapelbare Kopfzeilen, die sich erweitern, um zugehörige Inhalte anzuzeigen. Das Akkordeon-Muster ist entscheidend für **progressive Offenlegung**, da es Benutzern erlaubt, übergeordnete Informationen zu überfliegen und selbst zu wählen, welche Details sie anzeigen möchten. Die Skill enthält detaillierte Spezifikationen für Anatomie, Interaktionslogik (exklusiv/mehrfach offen), visuelle Hinweise, Barrierefreiheit nach ARIA/WCAG und responsive Anpassung. Sie eignet sich für FAQ-Abschnitte, mobile Menüs, komplexe Formulare oder Produktdetailseiten, sollte aber nicht bei kurzen Inhalten, kritischen Anweisungen oder suchintensiven Seiten verwendet werden. Der systematische Ansatz stellt sicher, dass Akkordeons die kognitive Last reduzieren, ohne kritische Informationen zu verstecken oder Barrieren für die Barrierefreiheit zu schaffen. Die Implementierung umfasst Entscheidungsregeln (wie die Chevron-Regel und die Erstes-Element-Regel), typische Fehlermuster und Validierungskriterien für die Qualitätssicherung.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Akkordeon-UI-System

Zweck

Die Skill „Akkordeon-UI-System“ bietet eine Methodik zum Entwerfen und Strukturieren von Akkordeons – gestapelte Kopfzeilen, die sich erweitern, um zugehörige Inhalte anzuzeigen. Dieses Muster ist essentiell für die progressive Offenlegung, die es Benutzern ermöglicht, übergeordnete Informationen zu überfliegen und selbst zu wählen, welche Details sie anzeigen möchten. Ein systematischer Ansatz für Akkordeons stellt sicher, dass sie die kognitive Last reduzieren, ohne kritische Informationen zu verstecken oder Barrieren für die Barrierefreiheit zu schaffen.

Anwendungsfälle

  • FAQ-Abschnitte: Organisation einer langen Liste von Fragen und Antworten in einer überfliegbaren Liste.
  • Mobile Menüs: Einklappen sekundärer Navigationselemente, um vertikalen Platz zu sparen.
  • Komplexe Formulare: Gruppieren verwandter Formularfelder in überschaubare, umschaltbare Abschnitte.
  • Produktdetails: Ausblenden technischer Spezifikationen, Versandinformationen oder Bewertungen auf E-Commerce-Seiten.
  • Filterung: Verwalten mehrerer Facettengruppen in einer Entdeckungs-Sidebar.

Wann NICHT verwenden

  • Kleine Inhaltsmengen: Wenn der gesamte Inhalt kurz ist, erhöht das Verstecken hinter einem Klick unnötige Interaktionskosten.
  • Kritische Anweisungen: Wenn ein Benutzer die Informationen lesen muss, um fortzufahren (z. B. rechtliche Warnungen oder „Schritt-für-Schritt“-Anleitungen), verstecken Sie sie nicht.
  • Suchintensive Seiten: Wenn Benutzer häufig die „Suchen“-Funktion des Browsers (Cmd/Ctrl+F) verwenden müssen; verborgene Akkordeon-Inhalte sind standardmäßig oft nicht durchsuchbar.
  • Einzelne Offenlegung: Verwenden Sie einen einfachen „Mehr anzeigen“-Link oder eine einzelne Offenlegungskomponente, wenn nur ein Inhalt umgeschaltet werden soll.

Eingaben

  1. Inhaltsinventar: Eine Liste von Kopfzeilen und dazugehörigen erweiterten Inhalten.
  2. Erweiterungslogik: Soll nur ein Element gleichzeitig geöffnet sein (exklusiv) oder können mehrere geöffnet sein?
  3. Auslösekontext: Wo wird das Akkordeon platziert? (z. B. Hauptinhaltsbereich, Sidebar oder mobiler Drawer?)
  4. Vorhandene Systeme: Abstands- und Typographieskalen des übergeordneten Designsystems.

Ausgaben

  1. Anatomie-Spezifikation des Akkordeons: Visuelle Definitionen für Kopfzeilen, Symbole, Paneele und Abstände.
  2. Interaktionsspezifikation: Verhalten für Erweiterung, Fokuszustände und Übergänge.
  3. Barrierefreiheits-Blueprint: ARIA-Rollen, -Zustände und Tastaturzuordnung.
  4. Responsive Strategie: Regeln für die Anpassung des Akkordeons an schmale Viewports.

Arbeitsablauf

1. Struktur der Inhaltsanatomie

Definieren Sie die Standardteile eines Akkordeon-Elements:

  • Die Kopfzeile (Auslöser): Der klickbare Bereich, der den Titel enthält.
  • Das Symbol (Hinweis): Normalerweise ein Chevron oder Plus/Minus-Zeichen, das die Erweiterbarkeit anzeigt.
  • Das Panel: Der Container, der die verborgenen Inhalte enthält.
  • Die Gruppe: Der übergeordnete Container, der die Beziehung zwischen mehreren Elementen verwaltet.

2. Visuelle Hinweise festlegen

Wenden Sie das visual-hierarchy-system an, um sicherzustellen, dass das Akkordeon erkennbar ist:

  • Zustandsanzeigen: Verwenden Sie Symbole (Chevrons), die sich drehen oder ändern, wenn das Akkordeon geöffnet ist.
  • Trennung: Verwenden Sie Rahmen, Hintergrundfarbverschiebungen oder vertikale Abstände (aus dem fluid-spacing-system), um Elemente zu unterscheiden.
  • Kopfzeilen: Stellen Sie sicher, dass der Kopfzeilentext interaktiv aussieht (höheres Gewicht oder andere Farbe).

3. Interaktionslogik definieren

Wählen Sie das Verhaltensmuster:

  • Exklusiv (Einzel-Öffnung): Das Öffnen eines Elements schließt automatisch die anderen. Am besten für Fokus und Reduzierung der Seitenlänge.
  • Mehrfach-Öffnung: Mehrere Elemente können geöffnet bleiben. Am besten, wenn Benutzer Informationen über Abschnitte hinweg vergleichen müssen.
  • Standardzustand: Bestimmen Sie, ob das erste Element standardmäßig geöffnet sein soll, um die Funktionalität zu signalisieren.

4. Für Abstände und Inhalt optimieren

Wenden Sie das fluid-spacing-system auf das Innere an:

  • Kopfzeilen-Padding: Stellen Sie sicher, dass das Touch-Ziel mindestens 24x24px beträgt (WCAG 2.2 SC 2.5.8 Minimum); bevorzugen Sie 44x44px, wo es das Layout erlaubt, für bequeme Touch-Nutzung.
  • Panel-Padding: Verwenden Sie internes Padding, um eine klare Beziehung zwischen der Kopfzeile und ihrem Inhalt herzustellen.
  • Übergänge: Verwenden Sie subtile Höhen- oder Deckkraftübergänge (200-300 ms), um den „Sprung“ beim Erscheinen des Inhalts zu mildern.

5. Barrierefreiheit und Reaktionsfähigkeit überprüfen

  • Tastatur: Benutzer müssen mit Tab zu Kopfzeilen navigieren und mit Enter/Leertaste umschalten können, gemäß dem ARIA APG Akkordeon-Muster.
  • ARIA: Wickeln Sie jeden Auslöser in ein Überschrift-Element (<h3><button aria-expanded="true/false" aria-controls="panel-id">...</button></h3>) und geben Sie dem Panel role="region" mit aria-labelledby, das auf den Auslöser verweist, wenn Paneele umfangreiche Inhalte enthalten.
  • Mobil: Stellen Sie sicher, dass lange Kopfzeilen elegant umbrechen und nicht mit Symbolen überlappen.

Entscheidungsregeln

  • Die Chevron-Regel: Fügen Sie immer einen visuellen Indikator (wie einen Chevron) auf der rechten Seite der Kopfzeile ein. Er sollte nach unten zeigen, wenn geschlossen, und nach oben, wenn geöffnet.
  • Die Erstes-Element-Regel: Öffnen Sie das erste Akkordeon-Element standardmäßig, wenn es die wichtigsten oder am häufigsten angeforderten Informationen enthält.
  • Textkürzung: Kürzen Sie Akkordeon-Kopfzeilen niemals ab. Wenn ein Titel lang ist, lassen Sie ihn auf mehrere Zeilen umbrechen, um Klarheit zu gewährleisten.
  • Ausrichtung: Halten Sie das Symbol zum Erweitern/Einklappen konsistent (normalerweise ganz rechts ausgerichtet), um einen vorhersagbaren Scan-Pfad zu schaffen.

Einschränkungen

  • Barrierefreiheit: Kopfzeilen müssen semantische Überschrift-Tags (H2-H4) verwenden, die einen <button> für den Tastaturzugriff enthalten; erfüllt WCAG 2.2 SC 2.5.8 Mindestzielgröße (24x24px).
  • Reaktionsfähigkeit: Die Akkordeon-Breite sollte fließend sein (100 % des Elternteils). Der Panel-Inhalt muss vollständig reaktionsfähig sein.
  • Hierarchie: Akkordeon-Kopfzeilen sollten visuell nie prominenter sein als die H1 der Seite.

Häufige Fehlermuster

  • Undurchsichtige Auslöser: Akkordeon-Kopfzeilen, die wie einfacher Text aussehen, sodass Benutzer nicht erkennen, dass sie klickbar sind.
  • Inhaltssprünge: Schnelle, ruckartige Übergänge, die die Bildlaufposition des Benutzers desorientieren.
  • Fehlende Fokuszustände: Vergessen, einen sichtbaren Fokusring für Tastaturbenutzer zu gestalten.
  • Überladene Paneele: Zu viele komplexe interaktive Inhalte (wie andere Akkordeons) in einem Panel platzieren, was zu „verschachtelter Inception“ führt.
  • Unzugängliches ARIA: Versäumnis, aria-expanded-Zustände programmatisch zu aktualisieren.

Validierungskriterien

  • Jedes Akkordeon-Element hat einen klaren visuellen Indikator (z. B. Chevron).
  • Kopfzeilen sind tastaturzugänglich (button-basiert) mit sichtbaren Fokuszuständen.
  • aria-expanded und aria-controls sind korrekt definiert.
  • Interne Abstände folgen dem fließenden Abstandssystem.
  • Die exklusive/Mehrfach-Öffnungs-Logik ist für den Inhaltstyp geeignet.
  • Das Akkordeon geht fließend über, ohne das Layout zu beeinträchtigen.
  • Touch-Ziele erfüllen das WCAG 2.2 Minimum von 24x24px (44x44px bevorzugt).

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 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 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