Communitygithub.com

Bildergalerie- und Lightbox-System

Entwerfen und implementieren Sie eine strukturierte, barrierefreie und responsive Bildergalerie sowie ein immersives Vollbild-Lightbox-System mit Touch-Wisch-Gesten, Tastaturnavigation und korrektem Fokusmanagement.

Was ist Bildergalerie- und Lightbox-System?

Das Bildergalerie- und Lightbox-System ist eine umfassende Designmethodik zur professionellen Präsentation von Medienkollektionen im Web. Es definiert den Aufbau einer statischen Galerierasteransicht und den nahtlosen Übergang in eine ablenkungsfreie Vollbild-Overlay-Ansicht (Lightbox). Das System ist ideal für Portfolio-Seiten, E-Commerce-Produktdetailseiten oder Nachrichtenmedien und stellt sicher, dass visuelle Assets hochgradig responsiv bleiben und die Barrierefreiheitsrichtlinien WCAG AA erfüllen. Es unterstützt sowohl Desktop- als auch mobile Geräte durch Touch-Wisch-Gesten, Tastatursteuerung und Fokusfallen. Die Implementierung umfasst Schritte zur Erstellung eines stabilen Galerierasters, zur Gestaltung der Lightbox-Hintergrundebene, zur Platzierung von Navigationssteuerelementen und Untertiteln sowie zur Integration von Tastatur- und Gestenmechaniken. Das System vermeidet typische Fehlermuster wie unendliche Tab-Fallen, Bildüberläufe oder fehlende Fokuswiederherstellung und wird durch klare Validierungskriterien abgesichert.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Bildergalerie- und Lightbox-System?

Zweck

Das Bildergalerie- und Lightbox-System bietet eine präzise Designmethodik zur Präsentation von Mediensammlungen im Web. Es strukturiert, wie eine Gruppe von Bildern oder Videos in einem statischen Raster (der Galerie) dargestellt wird und wie diese Assets in eine wirkungsvolle, ablenkungsfreie Vollbild-Overlay (die Lightbox) übergehen. Dieses System stellt sicher, dass visuelle Portfolios, E-Commerce-Produktvergrößerungen und Fallstudien hochgradig responsiv bleiben, eine tiefgehende Barrierefreiheit (WCAG AA) gewährleisten und physische Geräte durch Touch-Wisch-Gesten, Tastatursteuerung und Fokusfallen unterstützen.

Anwendungsfälle

  • Portfolio-Seiten, die Fotografie, Kunstwerke, Architekturdesigns oder Fallstudien präsentieren.
  • E-Commerce-Produktdetailseiten (PDPs), die eine detaillierte Bilderkundung in großem Maßstab erfordern.
  • Content-reiche Medienseiten, auf denen Artikel interaktive Fotogalerien enthalten.
  • Veranstaltungsseiten und Marketing-Landingpages, die Eventfotografie oder Erfahrungsberichte zeigen.
  • Immobilien-Websites, die Immobilien mit hochauflösenden Innen- und Außenansichten präsentieren.

Wann NICHT zu verwenden

  • Einzelner Hintergrund oder Inline-Medien: Für eigenständige, nicht gruppierte Hintergrundbilder oder einfache Inline-Diagramme in Artikeln, die nicht von einer Zoom- oder Karussell-Interaktion profitieren.
  • Datenschwere Dashboard-Ansichten: Wenn die Hauptaufgabe das Sortieren oder Analysieren strukturierter Datenpunkte (z. B. Tabellen oder Diagramme) ist, würde eine Vollbild-Overlay den Arbeitsbereich unterbrechen. Verwenden Sie stattdessen data-table-ui-system.
  • Komplexe Dokumente oder PDFs: Wenn Benutzer mehrseitige Textdokumente lesen müssen; Lightboxen sind für visuelle Medien optimiert, nicht für leseintensive Assets.
  • Unabhängige kontextuelle Modals: Wenn der Dialog Formulareingaben, Einstellungen oder interaktive Anwendungen anstelle von strukturierten Medien enthält. Verwenden Sie overlay-and-dialog-system oder settings-interface-system stattdessen.

Eingaben

  1. Medieninventar: Hochauflösende Quell-Assets und entsprechende niedrig aufgelöste oder komprimierte Thumbnail-Varianten.
  2. Kontextuelle Metadaten: Titel, Beschreibungen, Copyright-Informationen, Bildunterschriften und notwendige barrierefreie Alternativtexte (alt).
  3. Responsive Abstandsregeln: Ziel-Rasterabstände, Ränder und Layout-Spaltenregeln basierend auf den etablierten responsive-grid-system und fluid-spacing-system der Website.
  4. Interaktive Kontrastpalette: Barrierefreie Text- und Symbolfarben (die mindestens WCAG 4,5:1 Kontrast erfüllen) für Steuerungs-Overlays, Schaltflächen zum Schließen und Paginierungspunkte.

Ausgaben

  1. Galerie-Raster-Spezifikation: Definierte Spaltenlayouts, Bildseitenverhältnisse, Hover-Zustände und Regeln zur Erhaltung von Bildfokuspunkten.
  2. Lightbox-Anatomie-Plan: Struktur des Vollbild-Overlays mit Details zu Steuerelementen (Zurück, Weiter, Schließen), Positionen der Bildunterschriften und Thumbnail-Streifen-Layouts.
  3. Gesten- und Tastatur-Spezifikation: Eine vollständige Interaktionsmatrix, die Tastaturereignisse, Tipp-/Touch-Zonen und Drag-/Wisch-Verhalten abbildet.
  4. Barrierefreiheitsstruktur-Karte: Logische Rollen (dialog, group), Beschriftungen (aria-label), Fokusfallen-Regeln und Echtzeit-Zustandsansagen.

Arbeitsablauf

1. Aufbau des Galerieraster-Fundaments

Beginnen Sie mit der Strukturierung der primären Seitengalerie, um eine Balance zwischen Übersichtlichkeit und Bildschirmfläche zu schaffen:

  • Standardisierung des Seitenverhältnisses: Gruppieren Sie Galerie-Thumbnails mit einem einheitlichen Seitenverhältnis (z. B. 1:1 quadratisch oder 4:3 Standard), um einen geordneten Rhythmus zu etablieren. Verwenden Sie die CSS-Eigenschaft aspect-ratio, um Layoutsprünge zu vermeiden.
  • Abstände und Gassen: Verwenden Sie Token aus dem fluid-spacing-system (typischerweise --space-s oder --space-m) für Rasterabstände.
  • Hover-/Fokus-Affordanzen: Wenden Sie die Konventionen des interactive-state-system an. Wenn ein Benutzer über ein Thumbnail fährt oder es fokussiert, lösen Sie eine subtile visuelle Änderung aus (z. B. Zoom-Skalierung, weicher Overlay-Kontrast, benutzerdefinierter Such-/Zoom-Cursor), um zu signalisieren, dass das Element anklickbar ist.
  • Semantisches HTML: Strukturieren Sie die Galerie mit einem Listen-Wrapper (<ul> / <li>), wobei die Thumbnails als button-Elemente (oder als Links, wenn Indizierung/Tiefenverlinkung erforderlich ist) markiert werden, um die Tastaturerreichbarkeit zu gewährleisten.

2. Gestaltung des Vollbild-Lightbox-Hintergrunds

Der Lightbox-Hintergrund muss den Betrachter vom Rest der Seite trennen:

  • Verdunkelungsschicht: Legen Sie einen soliden oder leicht transparenten Hintergrund (z. B. #0a0a0a mit 95 % Deckkraft oder eine dunkle Hintergrundunschärfe) über die Seite, um periphere Ablenkungen zu eliminieren.
  • Erhaltung des Seitenverhältnisses: Positionieren Sie das aktive Bild absolut zentriert im Viewport. Stellen Sie sicher, dass der Container dynamisch mit max-width: 90vw und max-height: 80vh skaliert, um in jeden Viewport zu passen, ohne das Quellseitenverhältnis zu beschneiden.
  • Ladezustand: Erstellen Sie einen zentrierten visuellen Indikator (Spinner, Lade-Skeleton oder Fortschrittsring), der aria-bewusst ist (aria-busy="true"), um sicherzustellen, dass Benutzer wissen, dass hochauflösende Assets heruntergeladen werden.

3. Einrichtung von Navigationssteuerelementen und Bildunterschriften-Overlay

Positionieren und gestalten Sie Overlay-Elemente, um die Ergonomie auf Desktop und Mobilgeräten zu optimieren:

  • Schließen-Taste: Positionieren Sie die Schaltfläche zum Schließen in der oberen rechten Ecke. Sie muss eine klare visuelle Grenze haben, eine Mindest-Touch-Zielgröße von 48x48px (oder 44x44px gemäß WCAG) erfüllen und einen deutlichen Tastatur-Fokusring aufweisen.
  • Zurück- & Weiter-Pfeile: Zentrieren Sie die Navigationspfeile vertikal an den linken und rechten Rändern. Auf Mobilgeräten blenden Sie diese Pfeile aus oder setzen Sie sie leicht ein, um den Fokus vollständig auf Touch-Wisch-Aktionen zu legen.
  • Bildunterschriften und Index-Anzeige: Platzieren Sie semantische Bildunterschriften und Indizes (z. B. „Bild 3 von 12“) am unteren Rand des Containers. Verwenden Sie einen aria-live-Container, um Screenreader über Änderungsereignisse zu informieren, wenn sich der Index aktualisiert.
  • Thumbnail-Streifen: Zeigen Sie unter dem Hauptbild eine scrollbare Reihe kleiner Thumbnails an. Heben Sie das aktive Element mit einem dicken, kontrastreichen Rand und einer deutlichen :focus-Kontur hervor.

4. Integration von Tastatur- und Gestenmechaniken

Die Lightbox muss Desktop-Peripherie und mobile Gesteninteraktion mit gleicher Eleganz handhaben:

  • Tastaturbelegungen: Stellen Sie sofortige Unterstützung für Tastensteuerungen sicher: Escape schließt die Lightbox, ArrowRight/ArrowDown löst „Weiter“ aus, und ArrowLeft/ArrowUp löst „Zurück“ aus.
  • Fokusfalle: Wenn die Lightbox geöffnet wird, fangen Sie den Tastaturfokus darin ein. Benutzer sollten nicht zurück zur Hintergrundseite tabben können. Das erste fokussierte Element sollte der Hauptdialog-Container oder die Schließen-Taste sein.
  • Fokuswiederherstellung: Wenn die Lightbox geschlossen wird, stellen Sie den Fokus sofort auf die spezifische Thumbnail-Schaltfläche wieder her, die sie geöffnet hat.
  • Wischen-zum-Navigieren: Unterstützen Sie flüssige Touch-Wisch-Gesten nach links und rechts.
  • Wischen-zum-Schließen: Erlauben Sie das Ziehen oder Wischen vertikal (nach oben oder unten), um die Lightbox schnell zu schließen, und imitieren Sie damit native Muster mobiler Betriebssysteme.

5. Finalisierung der Barrierefreiheit und Dokumentationsstruktur

Wenden Sie erweiterte ARIA-Deklarationen an, um ein WCAG-AA-konformes Screenreader-Erlebnis zu gewährleisten:

  • Rollen und Beschriftungen: Markieren Sie den Lightbox-Wrapper mit role="dialog", aria-modal="true" und beschriften Sie ihn mit aria-label oder aria-labelledby, das auf den Titel/die Bildunterschrift verweist.
  • Hintergrundausblendung: Wenn die Lightbox aktiv ist, wenden Sie aria-hidden="true" auf den Hauptseiten-Wrapper (<main> oder #app-root) an, um Screenreader-Durchläufe auf das Overlay zu beschränken.
  • Live-Updates: Stellen Sie sicher, dass Änderungen des Bildtitels/der Bildunterschrift angesagt werden, indem Sie diese in einer aria-live="polite"-Zone platzieren oder darauf verweisen.

Entscheidungsregeln

  • Die Auflösungsteilung: Thumbnails im Galerieraster müssen stark komprimiert und angemessen dimensioniert sein (z. B. max-width 600px). Die Lightbox muss die hochauflösende Master-Variante laden, aber nur auf Anfrage (Lazy Loading der nächsten und vorherigen Folien), um mobile Bandbreite zu sparen.
  • Tastatur- vs. Touch-Priorisierung: Auf mobilen Viewports (Breiten < 768px) priorisieren Sie den Bildschirmplatz für das Bild. Blenden Sie Desktop-UI-Steuerelemente (Weiter-/Zurück-Pfeile) zugunsten von Touch-Wisch-Gesten aus, behalten Sie aber immer eine gut sichtbare „Schließen“-Schaltfläche.
  • Endlosschleife vs. Haltestelle:
    • Verwenden Sie die Endlosschleife (Karussell springt nach dem letzten Element zurück zum ersten), wenn kreative Portfolios, Erfahrungsberichte oder Produkte präsentiert werden, bei denen ein flüssiges Durchblättern bevorzugt wird.
    • Verwenden Sie eine Haltestelle (Weiter-Pfeil beim letzten Element deaktiviert) für schrittweise sequenzielle Tutorials, Anleitungen oder chronologische Zeitachsen, bei denen die Richtung entscheidend ist.
  • Bildunterschriften vs. Overlay-Platz: Wenn ein Bild eine lange Beschreibung hat, legen Sie sie nicht über das Bild selbst. Platzieren Sie sie in einer dedizierten unteren Leiste unterhalb der Bildgrenzen, sodass der Text unabhängig scrollen kann, wenn er den vertikalen Bildschirmplatz überläuft.
  • Desktop-Cursor-Affordanz: Ändern Sie den Desktop-Cursor dynamisch:
    • Beim Überfahren von Galerie-Thumbnails: cursor: zoom-in
    • Aktives Lightbox-Bild (vergrößerbar): cursor: zoom-in (Durch Klicken wird auf volle Auflösung vergrößert, der Cursor ändert sich zu cursor: zoom-out zum Schwenken).
    • Beim Überfahren des Lightbox-Hintergrunds: cursor: pointer (Durch Klicken wird das Overlay geschlossen).

Einschränkungen

  • Responsivität: Bilder dürfen in der Lightbox niemals verzerrt werden oder ihr Seitenverhältnis verlieren. Container müssen flexible Viewport-Einheiten (vw/vh) und CSS object-fit: contain verwenden, um streng innerhalb der Bildschirmgrenzen in allen Geräteausrichtungen zu bleiben.
  • Kontrastverhältnisse: Interaktive Steuerelemente wie Schließen, Navigation und Thumbnails müssen ein Kontrastverhältnis von mindestens 4,5:1 gegenüber dem Hintergrund und Bild-Overlays aufweisen.
  • Fokus-Zustände: Jedes aktive Navigationselement muss einen sichtbaren :focus-visible-Ring haben. Fokusindikatoren dürfen niemals durch Begrenzungsrahmen oder benachbarte Elemente abgeschnitten werden.
  • Touch-Ziele: Tippziele auf Mobilgeräten müssen WCAG 2.2 SC 2.5.8 (mindestens 24x24px, aber 44x44px wird für primäre Aktionen wie Schließen und Navigation dringend empfohlen) erfüllen.

Häufige Fehlermuster

  • Die „Unendliche Tab-Falle“: Aus der geöffneten Lightbox in die Hintergrundseite zu tabben, wodurch Screenreader unsichtbare Inhalte lesen und die Tastaturnavigation unterbrochen wird.
  • Der „Bildüberlauf“: Hohe Hochformatbilder, die über den oberen oder unteren Rand des mobilen Viewports hinausragen, wodurch Navigationspfeile oder Schaltflächen zum Schließen unerreichbar werden.
  • Fokuspunktverlust: Thumbnails in der statischen Galerie, die das Hauptmotiv (z. B. den Kopf einer Person) durch absolutes zentriertes Zuschneiden abschneiden. Lösen Sie dies durch object-position oder benutzerdefiniertes responsive Zuschneiden.
  • Der „Tote Escape“: Das Versäumnis, die Escape-Taste zu verdrahten, wodurch tastaturgesteuerte Benutzer ohne intuitive Möglichkeit zum Schließen im Modal-Overlay gefangen bleiben.
  • Layoutverschiebung beim Öffnen: Das Browser-Scrollbar verschwindet beim Öffnen der Lightbox, wodurch das gesamte Hintergrundseitenlayout springt oder seitlich verrutscht. Lösen Sie dies durch Hinzufügen eines passenden Abstands oder Scroll-Lock-Paddings.
  • Keine Fokuswiederherstellung: Das Schließen der Lightbox setzt den Fokus zurück an den Anfang der Sitemap oder auf den Body, sodass Tastaturbenutzer die gesamte Header-Navigation erneut durchtabben müssen, um zu ihrem ursprünglichen Punkt zurückzukehren.

Validierungskriterien

  • Galerie-Thumbnails verwenden ein standardisiertes Seitenverhältnis und haben klare Hover-/Fokus-Indikatoren.
  • Aktive Lightbox-Bilder behalten ihr Seitenverhältnis bei und passen perfekt in die Viewport-Grenzen (max-width: 90vw und max-height: 80vh).
  • Schaltfläche zum Schließen und Pfeile erfüllen ein Kontrastverhältnis von mindestens 4,5:1 gegenüber der Hintergrundebene.
  • Tastaturnavigation ist aktiv: Escape schließt, ArrowRight geht weiter, ArrowLeft geht zurück.
  • Der Fokus ist bei geöffneter Lightbox darin gefangen und wird beim Schließen perfekt auf das ursprüngliche Galerieelement wiederhergestellt.
  • Touch-Gesten sind aktiviert: Wischen nach links/rechts zum Navigieren, Wischen nach oben/unten zum Schließen auf mobilen Viewports.
  • Der Hauptseiten-Wrapper ist mit aria-hidden="truee" markiert, wenn das Lightbox-Modal aktiv ist.
  • Ein Ladezustands-Spinner ist sichtbar und mit aria-busy="true" markiert, wenn hochauflösende Assets geladen werden.

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