Communitygithub.com

Befehlspaletten-System

Ein systematischer Entwurfsrahmen für globale Befehlspaletten (Cmd+K-Panels), der tastaturgesteuerte Navigation, Befehlsausführung und Tastenkombinationserkennung in einem zugänglichen, reaktionsschnellen Overlay vereint.

Was ist Befehlspaletten-System?

Das Befehlspaletten-System ist ein umfassendes Entwurfsmuster für moderne Webanwendungen, das globale, tastaturgesteuerte Overlay-Menüs (wie Cmd+K oder Ctrl+K) definiert. Dieses Skill konzentriert sich darauf, eine systematische Struktur für die räumliche Ergonomie, visuelle Klarheit und vollständige WCAG 2.2 AA-Barrierefreiheit von Befehlspaletten zu schaffen. Es ist ideal für SaaS-Dashboards, Entwicklerportale, API-Referenzen und CRM- oder CMS-Administrationspanels, wo herkömmliche Navigationsleisten überlastet werden. Das System definiert die Auslöser, das Layout mit Such- und Filterbereich, Ergebnisfeld und Hilfsfußzeile, die visuelle Hierarchie der Befehlspaletten-Einträge sowie alle interaktiven Zustände und Tastaturnavigation. Es enthält Entscheidungsregeln (z. B. wann eine Befehlspalette vs. eine persistente Suchleiste verwendet wird), Zugänglichkeitsvorgaben nach ARIA APG Combobox-Muster, sowie Anpassungen für mobile Geräte (Vollbild-Overlay, Touch-Zielgrößen). Das Skill vermeidet häufige Fehlermuster wie unendliches Scrollen, fehlenden Hintergrund-Scroll-Lock oder unverständliche mobile Anzeigen und stellt umfassende Validierungskriterien für die Umsetzung bereit.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Befehlspaletten-System?

Zweck

Das Befehlspaletten-System bietet einen Gestaltungs- und räumlichen Rahmen für globale, tastaturausgelöste Overlay-Menüs (typischerweise mit Cmd+K oder Ctrl+K aufgerufen). In modernen, hochdichten Webanwendungen, Entwicklerplattformen und inhaltsreichen Dokumentationsportalen werden Standard-Navigationsleisten überlastet. Eine Befehlspalette fungiert als "Kommandozentrale", die Power-Usern direkte, reibungslose Tastaturpfade zum Suchen, Navigieren und Ausführen von Aktionen bietet und gleichzeitig als interaktives Wörterbuch der Tastaturkürzel dient.

Dieses Skill stellt sicher, dass Befehlspaletten räumlich ergonomisch und visuell strukturiert sind, um kognitive Ermüdung zu vermeiden, und vollständig den erweiterten Barrierefreiheitsspezifikationen (WCAG 2.2 AA) entsprechen.

Anwendungsfälle

  • Entwurf eines globalen, abkürzungsgesteuerten Arbeitsbereich-Controllers für SaaS-Dashboards.
  • Strukturierung entwicklerorientierter Portale und Dokumentationssuchportale (z. B. API-Referenzen).
  • Implementierung von Schnellaktions-Administrationspanels für Enterprise-CRM- oder CMS-Plattformen.
  • Erstellung einheitlicher Befehlszeilenschnittstellen (CLIs) innerhalb komplexer, mehrschichtiger Webprodukte.

Wann NICHT verwenden

  • Statische Marketing-Landingpages: Wo die Benutzerabsicht rein explorativ und konversionsorientiert ist; eine globale Navigationsleiste und klare Call-to-Actions (CTAs) sind effektiver.
  • Flache Informationsseiten (<15 Seiten): Wo der Aufwand für die Implementierung und Einführung einer Befehlspalette den Nutzen für die Navigation überwiegt.
  • Einfache mobile Verbraucherseiten: Wo der Bildschirmplatz minimal ist und Benutzer sich streng auf Touch-Interaktionen ohne externe physische Tastaturen verlassen.

Eingaben

  1. Befehls- und Aktionsinventar: Eine umfassende Taxonomie von durchsuchbaren Aktionen, Seiten, Einstellungen und Dokumenten.
  2. Kontextzuordnungsregeln: Regeln, welche Befehle global und welche kontextspezifisch sind (z. B. "Projekt löschen" nur beim Anzeigen eines Projekts).
  3. Tastaturkürzelsystem: Eine Zuordnung von Aktionen zu physischen Tastaturkürzeln (z. B. G dann D für "Gehe zu Dashboard").
  4. Marken-Design-Tokens: Typografieskalen, Farben, Abstandsverhältnisse und Schattentokens (aus fluid-spacing-system und fluid-typography-system).

Ausgaben

  1. Auslöser-Affordanz-Spezifikationen: Visuelle Gestaltungen für dauerhafte Einstiegspunkte und Tastaturkürzel-Badges.
  2. Paletten-Layout-Architektur: Rasterstrukturen für das Overlay-Modal, Gruppieren von Ergebnissen, Kategorienavigation und Hilfsfußzeilen.
  3. Visuelle Spezifikationen der Befehlspaletten-Einträge: Hierarchiespezifikationen für Symbole, Befehlstitel, Kategorie-Badges und Kürzel-Anmerkungen.
  4. Tastatur- und Zugänglichkeitsspezifikation: Exakte Tastaturereigniszuordnungen und ARIA-Zustandsspezifikationen, die dem ARIA APG Combobox-Muster entsprechen.

Workflow

1. Festlegen des Paletten-Auslösers und der Einstiegspunkte

Da eine Befehlspalette standardmäßig verborgen ist, müssen Sie auffindbare Einstiegspunkte entwerfen:

  • Der dauerhafte Header-Auslöser: Ein Button, der eine Suchleiste im globalen Header imitiert, mit einer Lupe, einem Textetikett (z. B. "Aktion suchen oder ausführen…") und einem rechtsbündigen Tastaturkürzel-Badge (z. B. ⌘K oder Ctrl+K).
  • Floating-Befehlsschaltfläche: Für dashboard-intensive oder Vollbild-Ansichtsfenster platzieren Sie einen dezenten Auslöser-Button in der unteren rechten Ecke des Viewports.
  • Unsichtbarer globaler Listener: Stellen Sie sicher, dass das Drücken von Cmd+K (macOS) oder Ctrl+K (Windows/Linux) überall im Dokument (außer der Fokus befindet sich in einem Texteingabefeld) sofort die Palette öffnet.

2. Entwurf des Modal-Overlays und des Hintergrunds (Scrim)

  • Hintergrund (Scrim): Verwenden Sie einen kontrastreichen, halbtransparenten Hintergrund (z. B. rgba(15, 23, 42, 0.4)), um die Hintergrundseite abzudunkeln und die Aufmerksamkeit vollständig auf die aktive Aufgabe zu lenken.
  • Vertikale Positionierung: Zentrieren Sie das Modal horizontal, verankern Sie es jedoch in den oberen 10 %–15 % des Viewports, anstatt einer absoluten vertikalen Zentrierung. Dies entspricht der natürlichen Augenhöhe und lässt Platz für die virtuelle Tastatur auf Touchscreens.
  • Größenbeschränkungen: Begrenzen Sie die Breite auf einen komfortablen Scan-Bereich – idealerweise zwischen 600px und 680px. Die Höhe sollte dynamisch sein, mit einem Maximum von 450px bis 550px, um sicherzustellen, dass sie niemals über kleine Laptop-Bildschirme hinausgeht.

3. Strukturieren des internen Layout-Rasters

Teilen Sie die Befehlspalette in vier separate horizontale Zonen auf:

  1. Die Such- und Filterzone: Ein randloses, vollbreites Eingabefeld mit einem markanten Suchsymbol (mind. 20px). Verwenden Sie Platzhaltertext, der den Benutzer führt (z. B. "Befehl eingeben oder suchen…").
  2. Die Kategoriefilterleiste (optional): Eine horizontale Reihe von kompakten Chips oder segmentierten Steuerelementen (z. B. "Alle", "Aktionen", "Seiten", "Benutzer"), mit denen Benutzer die Ergebnisse vor der Suche filtern können.
  3. Der Ergebnis-Feed (Scroll-Container): Eine scrollbare Listbox mit gruppierten Überschriften (z. B. "Zuletzt verwendet", "Navigation", "Systemeinstellungen").
  4. Die Hilfsfußzeile: Eine kontrastarme Statusleiste mit Tastaturhilfen (z. B. ↑↓ zum Navigieren, ↵ zum Auswählen, esc zum Schließen).
+-----------------------------------------------------------+
|  [Suchsymbol]  Befehl eingeben oder suchen...       [ESC] |
+-----------------------------------------------------------+
|  ( Alle )  ( Aktionen )  ( Seiten )  ( Mitglieder )  ( Hilfe ) |
+-----------------------------------------------------------+
|  ZULETZT VERWENDET                                        |
|  [Symbol] Gehe zu Abrechnung                   [ ⌘ G ] [ B ]|
|  [Symbol] Neue Rechnung erstellen              [ ⌘ N ]     |
|                                                           |
|  NAVIGATION                                               |
|  [Symbol] Dashboard                                        |
|  [Symbol] Team-Einstellungen                   [ ⌘ , ]     |
+-----------------------------------------------------------+
|  ↑↓ Navigieren  |  ↵ Auswählen  |  esc Schließen  |  ? Hilfedokumente |
+-----------------------------------------------------------+

4. Erstellen der visuellen Hierarchie der Befehlspaletten-Einträge

Jeder Eintrag in der Ergebnisliste muss innerhalb von Millisekunden erfassbar sein:

  • Linksbündiges Symbol: Ein explizites, kontrastreiches Symbol, das den Typ des Eintrags angibt (z. B. ein Dateisymbol für Dokumente, ein Zahnrad für Aktionen, ein Benutzeravatar für Personen).
  • Primärbezeichnung: Halbfetter, primärfarbener Text des Befehls selbst (z. B. "Teammitglied einladen").
  • Sekundäre Unterbezeichnung (optional): Gedämpfte, kleinere Beschreibung unter oder neben der Primärbezeichnung, um Kontext zu geben (z. B. "Einstellungen > Organisation").
  • Rechtsbündige Kürzel-Badges: Zeigen Sie das mit diesem Befehl verbundene physische Tastaturkürzel unter Verwendung kleiner, kontrastreicher Tasten-Badges an (z. B. ⌥I).

5. Definieren von interaktiven Zuständen und Tastaturauswahl

Eine Befehlspalette wird primär über die Tastatur gesteuert; daher hat der Tastaturauswahlzustand Vorrang vor dem Maus-Hover:

  • Aktiver/Fokussierter Eintragszustand: Wenn ein Eintrag mit den Pfeiltasten navigiert wird, wenden Sie eine markante Hintergrundfülländerung an (unter Verwendung des primären hellen Tokens, z. B. var(--color-primary-light)), und einen linken Randindikator. Der Primärtext sollte zur Markenfarbe wechseln.
  • Hover-Zustand (Maus): Spiegeln Sie den aktiven Tastaturzustand wider. Bewegen der Maus über Einträge sollte die Tastaturauswahl aktualisieren, um doppelte Fokuszustände zu vermeiden.
  • Leerer Zustand: Wenn eine Suche keine Ergebnisse liefert, zeigen Sie einen sauberen, illustrativen leeren Zustand an, der alternative Aktionen vorschlägt (z. B. "Keine Befehle gefunden. Versuchen Sie stattdessen, in unserem Hilfebereich zu suchen" mit einem Suchlink).
  • Ladezustand: Wenn Suchergebnisse asynchron abgerufen werden, zeigen Sie einen dezenten linearen Ladeindikator an der Basis des Sucheingabefelds an, und vermeiden Sie Skelettkarten, die Layoutverschiebungen verursachen.

Entscheidungsregeln

  • Die "Cmd+K vs. Persistente Suche"-Regel: Wenn der primäre Wert der Website der Konsum von strukturierten Inhalten ist (wie ein E-Commerce-Katalog), verwenden Sie eine persistente Suchleiste. Wenn der Wert in administrativen Arbeitsabläufen, der Befehlsausführung oder dichter Navigation liegt, verwenden Sie eine Cmd+K-Befehlspalette.
  • Die Gruppierungsbegrenzungsregel: Zeigen Sie niemals mehr als 3–4 Kategorien von Befehlen gleichzeitig an. Begrenzen Sie die maximal sichtbaren Einträge in jeder Kategorie auf 5 und bieten Sie eine "Mehr anzeigen…"-Option an, falls mehr vorhanden sind.
  • Die "Tastendruckzähl"-Regel: Physische Tastaturkürzel, die neben Befehlen angezeigt werden, dürfen niemals mehr als 3 Tasten umfassen (z. B. ist Strg+Umschalt+P akzeptabel; Strg+Alt+Umschalt+Z ist zu komplex).
  • Die dynamische Kontextregel: Filtern Sie Befehle dynamisch basierend auf der aktiven Route. Wenn sich ein Benutzer auf der Abrechnungsseite befindet, priorisieren Sie "Kreditkarte aktualisieren" oder "Rechnungs-PDF herunterladen" oben in der Standard-Ergebnisliste (ungetippt).

Einschränkungen

1. Barrierefreiheit (WCAG 2.2 AA Minimum)

  • ARIA Combobox-Muster: Sie müssen das Markup strikt nach dem ARIA Authoring Practices Guide (APG) strukturieren:
    • Der Eingabecontainer muss role="combobox", aria-expanded="true", aria-autocomplete="list" und aria-controls="command-listbox-id" haben.
    • Die Ergebnisliste muss role="listbox" haben, und jede Befehlspaletten-Zeile muss role="option" haben.
    • Während der Benutzer die Pfeiltasten drückt, muss die Eingabe aria-activedescendant aktualisieren, um auf die ID der aktiven Option zu verweisen, und diese Option muss aria-selected="true" haben.
  • Fokusverwaltung: Das Öffnen der Palette muss den Tastaturfokus innerhalb des Overlays einschließen. Das Drücken von Tab sollte entweder abgefangen werden, um innerhalb der Palette zu zirkulieren, oder vollständig deaktiviert sein (vorzugsweise mit Pfeiltasten für die Optionsnavigation). Das Schließen der Palette muss den Fokus genau auf das auslösende Element zurückgeben.
  • Screenreader-Ansagen: Platzieren Sie ein unsichtbares div mit aria-live="polite" und aria-atomic="true" neben der Eingabe. Bei einer Suche befüllen Sie dieses dynamisch mit dem Ergebnisstatus (z. B. "12 Ergebnisse gefunden, mit Aufwärts- und Abwärtspfeiltasten navigieren").
  • Kontrastverhältnisse: Alle Texte, Kürzel-Badges und Fokusindikatoren müssen WCAG AA erfüllen (4,5:1 Minimum für normalen Text, 3:1 für UI-Rahmen und Auswahlindikatoren).
  • Der Hintergrund-Sperre: Wenn die Palette aktiv ist, muss der Rest der Anwendung als inert dargestellt und für Screenreader ausgeblendet werden. Verwenden Sie <dialog>.showModal(), um Fokusfalle, Hintergrundabdunklung und natives Escape-Schließen nativ zu erreichen.

2. Reaktionsfähigkeit und Touch-Anpassungen

  • Touch-Viewport-Anpassung: Auf mobilen Bildschirmen muss die Befehlspalette zu einem Vollbild-Overlay oder einer nach unten gleitenden Schublade wechseln.
  • Virtuelle Tastaturbehandlung: Fokussieren Sie das Sucheingabefeld beim Öffnen automatisch und verwenden Sie inputmode="search", um sicherzustellen, dass das mobile Gerät die richtige "Suchen"-Aktionstaste auf seiner virtuellen Tastatur anzeigt.
  • Ausblenden physischer Hinweise: Auf Touch-Only-Geräten blenden Sie die physischen Tastaturkürzel-Badges (z. B. ⌘K oder ⌥I) aus, da sie irrelevant sind und visuelles Rauschen erzeugen.
  • Touch-Zielgrößen: Entfernbare Tags, Kategorie-Chips und Listenzeilen müssen auf Touch-Bildschirmen eine Höhe von mindestens 44px haben, um Fingertipps zu ermöglichen, gemäß WCAG 2.2 SC 2.5.8.

Häufige Fehlermuster

  • Die "Endlos-Scroll"-Falle: Zulassen, dass der Ergebnis-Feed 100+ Treffer ohne einen Scroll-Container rendert, wodurch der Bildschirm überläuft und die Fußzeilenanleitungen unzugänglich werden.
  • Fehlen einer Hintergrund-Scroll-Sperre: Zulassen, dass das Hintergrunddokument scrollt, während der Benutzer die Befehlspalette scrollt, was zu einer Desorientierung des Layouts führt.
  • Verlieren des Eingabefokus: Wenn Sie auf einen Kategorie-Chip oder Ergebnis-Eintrag klicken und den Tastaturfokus vom Texteingabefeld verlieren, müssen Tastaturbenutzer zurücktabben.
  • Unverständliche mobile Anzeige: Beibehalten eines kleinen, desktop-zentrierten Modals auf einem 320px-Mobilbildschirm, wodurch primäre Bezeichnungen und Kürzel-Badges abgeschnitten werden.
  • Fehlendes Spiegeln des Auslöserzustands: Der dauerhafte Header-Button zeigt das Tastaturkürzel nicht an, sodass Tastaturbenutzer nicht wissen, dass eine Befehlspalette existiert.

Validierungskriterien

  • Ein dauerhafter Auslöser-Button ist im Header mit einem klaren Cmd+K/Ctrl+K-Kürzel-Badge vorhanden.
  • Drücken von Cmd+K oder Ctrl+K an einer beliebigen Stelle auf der Seite öffnet das Modal.
  • Der Tastaturfokus wird sofort auf das Sucheingabefeld verschoben, und das Scrollen der Hintergrundseite wird gesperrt.
  • Die Navigation durch Optionen erfolgt mit den Aufwärts- und Abwärtspfeiltasten, mit einem gut sichtbaren aktiven Fokus.
  • Optionszeilen weisen eine strukturierte Hierarchie auf: Linkes Symbol, Fetter Aktionsname, Kontextuelle Pfadhierarchie und Rechtes Kürzel-Badge.
  • Das ARIA APG Combobox-Muster ist vollständig spezifiziert, einschließlich role="combobox", role="listbox", role="option" und aria-activedescendant.
  • Ein aria-live="polite"-Bereich ist vorhanden, um Screenreader über Änderungen der Suchergebnisanzahl zu informieren.
  • Auf mobilen Viewports passt sich die Palette an Vollbild oder eine untere Schublade an, blendet physische Kürzel-Badges aus und dimensioniert Zeilen auf eine Mindesthöhe von 44px.
  • Drücken von Escape oder Klicken auf den Hintergrund-Scrim schließt die Palette und gibt den Fokus an den Auslöser-Button zurück.

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