Communitygithub.com

Scroll-Video-Website

Baue oder verfeinere eine Webseite, bei der natives Scrollen ein freigegebenes Video steuert und Objektübergänge in den Seiteninhalt koordiniert. Für scrollgesteuerte filmische Eintritte und fotografische Objektbewegungen, nicht für gewöhnliche Autoplay-Videoeinbettungen.

Was ist Scroll-Video-Website?

Diese Fähigkeit ermöglicht es Entwicklern, eine interaktive Webseiteninteraktion zu erstellen, bei der natives Scrollen die Wiedergabe eines Videos vor- und zurückbewegt (Scrubbing) und gleichzeitig separate Objektübergänge (wie Produktdrehungen, Raumöffnungen oder Kunstwerke) in den Seiteninhalt überführt. Der Fokus liegt auf hochwertigen, fotografischen Bewegungen, die nahtlos mit dem Inhalt verschmelzen, anstatt auf herkömmlichen Autoplay-Videofunktionen. Sie verwendet natives Scrollen, einen fixierten (sticky) visuellen Bereich und requestAnimationFrame, um eine flüssige, reaktionsschnelle Steuerung ohne erzwungenes Scrollrad-Verhalten zu ermöglichen. Die Implementierung umfasst wichtige Schritte wie die Inspektion der bestehenden Site, die korrekte Vorbereitung von Videomaterialien mit optimierten Keyframes, die logische Aufteilung der Scrollstrecke in sinnvolle Bereiche für verschiedene Bewegungsphasen sowie die Beibehaltung der Zugänglichkeit mit Navigation, Sprung-Funktionen und Unterstützung für reduzierte Bewegung. Die Fähigkeit ist plattformunabhängig und priorisiert Browser-Kompatibilität und strenge Tests sowohl auf Desktop als auch auf Mobilgeräten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsmanuelarx/creative-web-animation-skills/tree/HEAD/skills/scroll-video-website

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Scroll-Video-Website?

Verwandele eine freigegebene visuelle Sequenz in eine reaktionsschnelle, umkehrbare Website-Interaktion. Verwende den vorhandenen Stack der Website und die genehmigten Assets; die Technik erfordert keine bestimmte Animationsbibliothek. Das Subjekt, der Pfad und das Ziel sind Projekteingaben. Wende den Workflow auf Produktdrehungen, Innenraumentschleierungen, Kunstwerke oder andere visuelle Geschichten an. Eine fallende Schallplatte und ein Plattenspieler sind Beispiele, keine erforderliche Szene.

Etabliere die Interaktion

Überprüfe die aktuelle Implementierung, die genehmigte Version und das neueste Benutzerfeedback, bevor du Änderungen vornimmst. Kläre aus diesem Kontext:

  • Welche Bewegung befindet sich im Video und welche Objekte werden separat im Code animiert?
  • Steuert das Scrollen den gesamten Clip, oder geht ein bewusster zeitgesteuerter Abschnitt dem Scrollen voraus? Folge dem ausgewählten Verhalten. Eine "Von Anfang an scrollen"-Anforderung muss beim ersten Mausrad- oder Touch-Scrollen ohne eine Klick-Hürde funktionieren.
  • Wo wird die letzte Szene zu gewöhnlichem Seiteninhalt? Wie können Besucher den Hauptinhalt direkt erreichen?
  • Welche Größen und Plattformen sind wichtig und welche Vorschau muss verfügbar bleiben?

Wenn nur Timing- oder Steuerungsänderungen angefordert werden, generiere keine Medien neu. Speichere die aktuelle funktionierende Version und erstelle eine isolierte Alternative, wenn ein Vergleich angefordert wird.

Bereite die Medien vor

Verwende das exakte Video und die entsprechenden dekodierten Start-/Endstandbilder. Bewahre die Farbinterpretation, das Seitenverhältnis und die Quelldatei. Wenn die Naht selbst falsch ist, behebe die Medienübergabe, bevor du sie mit Interaktionseffekten versteckst.

Überprüfe Dauer, Bildrate, Abmessungen und das Suchverhalten. Kürzere Keyframe-Intervalle können das Scrubbing erleichtern; eine All-Keyframe-Kopie kann für einen lokalen Prototyp nützlich sein, aber zu groß für die Bereitstellung werden. Teste das Derivat im tatsächlichen Browser und optimiere die Auslieferung separat. Schreibe keine einzige Codierungseinstellung für jeden Clip vor.

Behalte ein Poster bei, während Metadaten und Frames geladen werden. Behalte die letzte angeforderte Zeit bei und wende sie an, wenn das Video bereit ist. Ein fehlendes oder abgelehntes Video muss einen nutzbaren statischen Pfad zum Inhalt hinterlassen.

Karte Scrollen auf eine Zeitleiste

  1. Verwende eine native Scrollspur und eine fixierte visuelle Bühne, wenn sie in das bestehende Layout passen. Halte das Dokument sofort scrollbar, wenn Scrollen die Eingangssteuerung ist. Vermeide Radabfangen und Touch-Erfassung, nur um eine Bildlaufleiste zu simulieren.
  2. Teile die ausgewählte Geschichte in sinnvolle Bereiche auf, wie z. B. Objektbewegung, Kamerafreigabe, eine beruhigte Szene, Objektübergabe und Inhalt. Verwende nur die Phasen, die dem Projekt dienen; eine Produktdrehung muss keinen Fall oder eine Raumöffnung beinhalten. Weise jedem Bereich genügend Distanz für kurze, aber wichtige Ereignisse zu. Bilde jeden Bereich auf seinen Medien- oder Transformationsfortschritt ab; die Sekunden des Clips müssen nicht gleichmäßig auf Scroll-Pixel abgebildet werden.
  3. Aktualisiere mit einem requestAnimationFrame, das von Scroll-Ereignissen geplant wird. Lies das Layout beim Messen, nicht wiederholt innerhalb jedes Animations-Updates.
  4. Halte das Video zum Scrubbing angehalten. Vereinheitliche Suchen: Speichere das letzte Ziel, starte keine konkurrierende Suche, während eine aussteht, und wende das letzte Ziel nach seeked an. Baue keinen Rückstand veralteter Frames auf.
  5. Begrenze die Endpunkte mit einer kleinen Pixel-Toleranz für gebrochene Viewport-Berechnungen. Teste den ersten und letzten Frame mit tatsächlichen Browser-Scrollpositionen.
  6. Lasse angehaltenes Scrollen den aktuellen Zustand beibehalten. Kehre jede Phase gemäß der gewählten Interaktion um, einschließlich der Startaktion, wenn der gesamte Clip scrollgesteuert ist.
  7. Brich programmgesteuerte Reise ab, wenn der Besucher Mausrad-, Touch- oder Navigationstaste-Eingaben liefert. Verhindere, dass die Größenänderung und wiederhergestellte Scrollpositionen unerwartet den Startzustand überspringen.

Definiere bei einem hybriden Einstieg explizit, welches Segment zeitgesteuert ist und wo das Rückwärtsscrollen stoppt. Führe nicht stillschweigend ein zeitgesteuertes Segment in eine vollständig scrollgesteuerte Erfahrung ein.

Halte fotografische Objekte kontinuierlich

Verwende nach Möglichkeit ein sichtbares Objekt durch die gewählte Bewegung und Übergabe, z. B. ein Produkt, das in seine Detailansicht übergeht, oder ein Kunstwerk, das in eine Galerie überführt wird. Wenn du es auf ein Ziel umsetzt (reparent), passe seine Position und Projektion vor und nach dieser Änderung an.

Eine vollständige Überschlag-Drehung benötigt eine 3D-Rotation, die die Kante freilegt. Eine flache, in der Ebene liegende Rotation ist eine andere Bewegung. Eine texturierte Ebene kann für ein flaches Objekt wie einen Druck oder eine Schallplatte geeignet sein; beschreibe es nicht als vollständig modellierte 3D-Szene. Ein festes Produkt, dessen Silhouette sich während der Drehung ändert, benötigt geeignete gefilmte/generierte Ansichten oder ein 3D-Asset.

Halte Quell- und Zielmessungen in einem konsistenten Koordinatensystem. Mische keine Viewport- und Dokumentkoordinaten, wenn eine Bühne fixiert ist. Messe bei Größenänderung neu und bewahre sinnvollen Fortschritt. Ordne abhängige Aktionen nach ihrer physischen Ursache an. Wenn das Ziel beispielsweise ein Plattenspieler ist, halte die Nadel angehoben, bis die Schallplatte landet, senke sie dann ab, bevor der Abspielzustand beginnt.

Verschmelze Szenengrenzen mit übereinstimmender Beleuchtung und Szenengeometrie. Halte Überschriften und Inhaltslinks lesbar, anstatt sie über visuell überladene Bilder zu legen. Bei einem schmalen Viewport lasse den Inhalt unter dem Objekt liegen, wenn nicht genügend Platz daneben ist.

Bewahre den Website-Zugriff

Zeige die Navigation am gewählten Punkt der Geschichte an, nicht erst nachdem ein langer Film zu Ende ist. Behalte direkten Kategoriezugriff, Überspringen, Wiederholung und einen Weg zurück zur Szene bei. Wenn Kategoriewechsel das Objekt austauschen sollen, koordiniere dies mit dem ausgewählten Inhalt und allen abhängigen Bewegungen; schnelle Auswahlen sollten auf der letzten Anfrage verweilen.

Fokussiere kein Ziel, während es oder ein Vorfahre inaktiv (inert) ist. Mache es zuerst interaktiv, dann fokussiere es ohne einen zusätzlichen Scroll-Sprung. Stelle den Fokus nach dem Schließen von Projektdialogen wieder her.

Ein Pfad mit reduzierter Bewegung sollte nutzbare statische Szenen ohne Scrubbing oder Drehen zeigen, auch beim Rückwärtsscrollen. Halte den fehlgeschlagenen Medienzustand persistent, sodass Rückwärtsscrollen kein defektes Overlay wiederherstellen kann.

Verifiziere und übergib

Verwende die unterstützten Browser-Tools, um echte Eingaben zu testen, nicht nur Aufrufe interner Animationsfunktionen:

  • Lade die Seite frisch, scrolle ohne zu klicken. Halte teilweise an, fahre fort und kehre dann zum Start zurück.
  • Überprüfe visuell die Video-/Standbild-Übergabe und die Objekt-zum-Ziel-Verbindung.
  • Erreiche den Hauptinhalt mit dem animierten Objekt an der richtigen Stelle, wenn ein Objektübergang Teil des Designs ist. Führe Kategoriewechsel, Überspringen, Wiederholen und Tastaturfokus aus.
  • Überprüfe Desktop- und Handy-Layouts, Größenänderung während der Reise, reduzierte Bewegung und ein absichtlich nicht verfügbares Video.
  • Überprüfe horizontalen Überlauf, Medienladung und Konsolenfehler. Unterscheide Browser-Emulation von einem physischen Handy-Test.

Liefere die Review-URL, einen aussagekräftigen Screenshot, die erhaltene Basislinie und alle wesentlichen Leistungs- oder Gerätetestgrenzen. Halte ein prägnantes Manifest bei, das die Quellmedien und das Timing identifiziert. Die Implementierung einer lokalen Überprüfung berechtigt nicht automatisch zur Veröffentlichung.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills