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
- Inhaltsinventar: Eine Liste von Kopfzeilen und dazugehörigen erweiterten Inhalten.
- Erweiterungslogik: Soll nur ein Element gleichzeitig geöffnet sein (exklusiv) oder können mehrere geöffnet sein?
- Auslösekontext: Wo wird das Akkordeon platziert? (z. B. Hauptinhaltsbereich, Sidebar oder mobiler Drawer?)
- Vorhandene Systeme: Abstands- und Typographieskalen des übergeordneten Designsystems.
Ausgaben
- Anatomie-Spezifikation des Akkordeons: Visuelle Definitionen für Kopfzeilen, Symbole, Paneele und Abstände.
- Interaktionsspezifikation: Verhalten für Erweiterung, Fokuszustände und Übergänge.
- Barrierefreiheits-Blueprint: ARIA-Rollen, -Zustände und Tastaturzuordnung.
- 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
Tabzu Kopfzeilen navigieren und mitEnter/Leertasteumschalten 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 Panelrole="region"mitaria-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-expandedundaria-controlssind 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).