Zum Inhalt springen

← Zurück zum Beitrag

Claude Code vs. Codex vs. Cursor

6.8.2026

Feature-Spezifikation: Foto Carousels

Markdown herunterladen

Feature: Foto-Carousels

Hinweis zur Terminologie: Dieses Beispiel verwendet Fachbegriffe aus dem zugrunde liegenden semantischen Datenmodell, etwa PublishedWork und Carousel. Dieses Modell ist hier jedoch nicht als weiteres Blog-Beispiel enthalten

Zusammenfassung

Ein Carousel ist ein für Besucher sichtbares PublishedWork, das eine bewusst geordnete Abfolge von Fotos enthält. Es ermöglicht dem Fotografen, zusammengehörige Bilder als ein zusammenhängendes Werk mit einem öffentlichen Namen, einem Titelfoto, einem lokalisierten Titel und einer lokalisierten Beschreibung zu veröffentlichen.

Ein Carousel ist keine Serie. Ein Carousel wird als einzelner Portfolioeintrag geöffnet und betrachtet; eine Serie stellt mehrere PublishedWorks zusammen und kann sowohl Carousels als auch eigenständige Werke enthalten.

Ziele

  • Eine zusammengehörige Abfolge veröffentlichen, ohne jedes enthaltene Foto als eigenen Galerieeintrag darzustellen.
  • Einen gemeinsamen künstlerischen Titel und eine gemeinsame Beschreibung für die Abfolge bewahren.
  • Fotospezifische Darstellungen, Aufnahmedaten, das Jahr und die Klassifizierung der Personensichtbarkeit bewahren.
  • Carousel-Veröffentlichungen bereits vor dem Öffnen erkennbar machen.
  • Eindeutige, barrierefreie Bedienelemente für die Navigation auf Foto- und PublishedWork-Ebene bereitstellen.
  • Einem Carousel ermöglichen, an der Zusammenstellung von Serien, der Hervorhebung neuer Veröffentlichungen und der Auffindbarkeit über die Suche teilzunehmen sowie dieselbe öffentliche Routenstruktur wie ein eigenständiges Werk zu verwenden.

Domänenregeln

  • Ein Carousel ist genau ein PublishedWork vom Typ Carousel.
  • Es enthält eine geordnete Liste von Fotos und umfasst normalerweise mindestens zwei.
  • Sein Titelfoto ist eines der enthaltenen Fotos und wird in der Galerie sowie beim Teilen verwendet.
  • Alle enthaltenen Fotos haben denselben für Besucher sichtbaren Titel und dieselbe Beschreibung wie das Carousel.
  • Jedes enthaltene Foto behält seine eigenen Vorschau- und Detailbilder, Aufnahmedaten, sein Jahr und seine Klassifizierung der Personensichtbarkeit.
  • Ein enthaltenes Foto wird nicht zusätzlich als eigenständiges PublishedWork veröffentlicht.
  • Ein Foto gehört im aktuellen Produkt zu höchstens einem Carousel.
  • Eine optionale Serienzugehörigkeit und der Neu-Status gehören zum PublishedWork des Carousels, nicht zu den einzelnen enthaltenen Fotos.

Darstellung in der Galerie

Ein Carousel erscheint genau einmal in der Galerie und verwendet dabei sein Titelfoto. Seine Kachel:

  • zeigt den lokalisierten Titel des Carousels;
  • ist sichtbar als Carousel gekennzeichnet;
  • vermittelt die Anzahl der Fotos sowohl visuell als auch in der barrierefreien Linkbezeichnung; und
  • zeigt den Neu-Status, wenn das PublishedWork des Carousels hervorgehoben ist.

Die Auswahl der Kachel öffnet die Detailseite des Carousels beim ersten Foto. Enthaltene Fotos erhalten keine eigenen Galeriekacheln oder Besucherrouten.

Darstellung im Detail

Die Detailseite des Carousels:

  • zeigt jeweils ein Foto;
  • wählt anfangs das erste Foto aus;
  • zeigt den gemeinsamen lokalisierten Titel und die gemeinsame Beschreibung des Carousels;
  • ergänzt den Titel um das Aufnahmejahr des sichtbaren Fotos, sofern dieses bekannt ist;
  • zeigt die Aufnahmedaten des sichtbaren Fotos;
  • zeigt einen Personenhinweis nur, wenn das sichtbare Foto einen erfordert;
  • zeigt eine lokalisierte Position wie 2 von 6; und
  • bietet Bedienelemente für das vorherige und nächste Carousel-Foto.

Der gemeinsame Titel und die gemeinsame Beschreibung werden nicht so wiederholt, als handele es sich bei jedem Foto um unterschiedliche Inhalte. Auch individuelle, nicht sichtbare Fototitel werden nicht eingeführt.

Zwei Navigationsebenen

Carousel-Seiten stellen bewusst zwei getrennte Gruppen von Bedienelementen bereit.

Bedienelemente für PublishedWorks

Die Bedienelemente für das erste, vorherige, nächste und letzte Werk navigieren zwischen den PublishedWorks im gesamten Portfolio. Sie wechseln niemals nur um eine Position innerhalb des Carousels.

Die Bedienelemente für das vorherige und nächste Foto navigieren ausschließlich innerhalb des aktuellen Carousels. Beim ersten beziehungsweise letzten Foto sind sie deaktiviert und wechseln niemals zu einem anderen PublishedWork. Eine sichtbare Positionsanzeige vermittelt den Fortschritt innerhalb der Abfolge.

Die Bedienelemente haben unterschiedliche lokalisierte barrierefreie Bezeichnungen, sodass Besucher erkennen können, ob eine Aktion den Portfolioeintrag oder das Foto innerhalb dieses Eintrags wechselt.

Fortlaufende Tastatur- und Wischgestennavigation

Bei der Navigation mit der Pfeiltaste nach links oder rechts sowie mit horizontalen Wischgesten verhält sich das Carousel wie ein zusammenhängender Abschnitt des Portfolios:

  • Eine Vorwärtsbewegung wechselt zum nächsten Carousel-Foto.
  • Beim letzten Foto öffnet eine weitere Vorwärtsbewegung das nächste PublishedWork.
  • Eine Rückwärtsbewegung wechselt zum vorherigen Carousel-Foto.
  • Beim ersten Foto öffnet eine weitere Rückwärtsbewegung das vorherige PublishedWork.

Die Escape-Taste führt zurück zur Galerie. Die Gestenerkennung bleibt auf den Bildbereich beschränkt und bevorzugt vertikales Scrollen, sofern die Bewegung nicht eindeutig horizontal ist.

Dieses Überschreiten der Grenzen gilt nur für die Navigation per Tastatur und Wischgeste. Sichtbare Carousel-Bedienelemente bleiben auf das Carousel beschränkt, und sichtbare PublishedWork-Bedienelemente bleiben auf Werkebene.

Ladeverhalten

  • Jedes Carousel-Foto folgt demselben Ladeverhalten mit zuerst geladenem Vorschaubild und anschließendem Detailbild wie ein eigenständiges Foto.
  • Die Navigation zu einem anderen Foto setzt den Lade- und Fehlerstatus für dieses Foto zurück.
  • Benachbarte Carousel-Fotos werden vor ihrer Verwendung vorbereitet.
  • An den Grenzen eines Carousels kann das Titelfoto des benachbarten PublishedWorks vorbereitet werden, damit die fortlaufende Navigation schnell reagiert.

Verhalten in Serien

  • Ein Carousel kann zu einer Serie gehören.
  • Unabhängig von der Anzahl seiner Fotos belegt es in dieser Serie eine Position und zählt als ein PublishedWork.
  • Seine Serienzugehörigkeit wird auf der Detailseite angezeigt und verlinkt.
  • In der Serienübersicht bleibt es als Werk mit mehreren Fotos erkennbar.

Auffindbarkeit und Teilen

  • Das Carousel besitzt in jeder Sprache eine stabile PublishedWork-URL.
  • Der lokalisierte Titel und die lokalisierte Beschreibung des Carousels beschreiben die Seite.
  • Das Titelfoto ist das primäre Vorschaubild beim Teilen in sozialen Medien.
  • Suchmetadaten können alle enthaltenen Fotos in der Reihenfolge des Carousels mit dessen Seite verknüpfen, wobei das Titelfoto an erster Stelle bleibt.
  • Enthaltene Fotos erzeugen keine eigenen PublishedWork-Einträge in der Sitemap.

Veröffentlichungsverhalten

Der Veröffentlichungsprozess muss Folgendes festlegen können:

  • die geordnete Zugehörigkeit der Fotos;
  • das Titelfoto;
  • den stabilen öffentlichen Namen;
  • den deutschen und englischen Titel sowie die deutsche und englische Beschreibung;
  • die optionale Serienzugehörigkeit und Position innerhalb der Serie;
  • ob das Carousel vorübergehend als neu hervorgehoben wird; und
  • die Personensichtbarkeit für jedes enthaltene Foto.

Der Veröffentlichungsprozess kann ein Carousel ableiten, wenn die Asset-Namen von mindestens zwei Fotos dieselbe Basis besitzen, auf die unmittelbar vor dem Suffix ihrer Darstellung ein numerischer Index folgt. Die abgeleitete Reihenfolge richtet sich aufsteigend nach diesem numerischen Index, das erste Foto ist das standardmäßige Titelfoto und die gemeinsame Basis ist der standardmäßige öffentliche Name. Die Ableitung liefert lediglich Vorschläge: Veröffentlichungstext, Datenschutzklassifizierung und Zusammenstellung müssen weiterhin geprüft werden.

Sonderfälle

  • Ein Carousel mit fehlenden Fotoreferenzen zeigt die gültig referenzierten Fotos in ihrer zusammengestellten Reihenfolge. Kann keine Fotoreferenz aufgelöst werden, ist das PublishedWork nicht verfügbar.
  • Ein Carousel mit nur einem Foto kann zu Wiederherstellungszwecken technisch darstellbar sein. Für eine reguläre Veröffentlichung sollte jedoch ein eigenständiges Werk verwendet oder die Abfolge um die fehlenden Fotos ergänzt werden.
  • Bedienelemente auf Werkebene und das Überschreiten der Grenzen per Tastatur oder Wischgeste werden automatisch deaktiviert, wenn sich das Carousel am Anfang oder Ende des gesamten Portfolios befindet.
  • Das Jahr und der Personenhinweis können wechseln, während der gemeinsame Titel und die gemeinsame Beschreibung unverändert bleiben.

Akzeptanzkriterien

  • Ein Carousel erscheint genau einmal als erkennbarer Galerieeintrag mit mehreren Fotos und einer Mengenangabe.
  • Beim Öffnen beginnt es mit dem ersten Foto und zeigt jeweils ein Foto.
  • Titel und Beschreibung werden von der gesamten Abfolge gemeinsam verwendet.
  • Jahr, Aufnahmedaten, Ladestatus und Personenhinweis richten sich nach dem sichtbaren Foto.
  • Interne Bedienelemente navigieren nur innerhalb des Carousels und sind an dessen Grenzen deaktiviert.
  • PublishedWork-Bedienelemente navigieren immer zwischen Portfolioeinträgen.
  • Die Pfeiltasten nach links und rechts sowie Wischgesten durchlaufen zuerst die Fotos und wechseln an den Grenzen der Abfolge zu benachbarten PublishedWorks.
  • Die aktuelle Position ist lokalisiert und wird als Text ausgegeben.
  • Ein Carousel belegt eine Position in einer Serie und besitzt eine öffentliche Route.
  • Suche und Teilen verwenden den Text und das Titelfoto des Carousels, während alle enthaltenen Bilder in den Seitenmetadaten berücksichtigt werden können.
  • Enthaltene Fotos werden nicht zusätzlich als eigenständige Werke veröffentlicht.

Nicht Bestandteil dieses Features

  • Automatische Wiedergabe als Diashow.
  • Öffentliche Titel oder Beschreibungen für einzelne Fotos innerhalb eines Carousels.
  • Navigation per Wischgeste in der Galerieübersicht.
  • Die Verwendung eines Fotos in mehreren Carousels.
  • Ein Carousel, das andere Carousels oder Serien enthält.