HyperFrames
HTML ist die zentrale Wahrheitsquelle für Video. Eine Komposition ist eine HTML-Datei mit data-*-Attributen für das Timing, einer GSAP-Timeline für Animationen und CSS für das Erscheinungsbild. Das Framework übernimmt die Clip-Sichtbarkeit, Medienwiedergabe und Timeline-Synchronisation.
Vorgehensweise
Bevor du HTML schreibst, denke auf einer hohen Ebene nach:
- Was – Was soll der Zuschauer erleben? Identifiziere den Erzählbogen, die Schlüsselmomente und die emotionalen Höhepunkte.
- Struktur – Wie viele Kompositionen, welche sind Unterkompositionen vs. inline, welche Spuren enthalten was (Video, Audio, Overlays, Untertitel).
- Timing – Welche Clips bestimmen die Dauer, wo liegen die Übergänge, wie ist das Tempo.
- Layout – Baue zuerst den Endzustand auf. Siehe „Layout vor Animation“ unten.
- Animation – Füge dann Bewegung mit den folgenden Regeln hinzu.
Bei kleinen Änderungen (Farbe korrigieren, Timing anpassen, ein Element hinzufügen) kannst du direkt zu den Regeln springen.
Visuelles Identitätstor
Überprüfe in dieser Reihenfolge:
- Existiert DESIGN.md im Projekt? → Lies es. Verwende seine exakten Farben, Schriftarten, Bewegungsregeln und „Was NICHT zu tun ist“-Einschränkungen.
- Existiert visual-style.md? → Lies es. Wende sein
style_prompt_fullund seine strukturierten Felder an. (Hinweis:visual-style.mdist eine projektspezifische Datei.visual-styles.mdist die Stilbibliothek mit 8 benannten Vorlagen – andere Dateien.) - Hat der Benutzer einen Stil genannt (z. B. „Swiss Pulse“, „dunkel und technisch“, „Luxusmarke“)? → Lies visual-styles.md für die 8 benannten Vorlagen. Erstelle eine minimale DESIGN.md mit:
## Stil-Prompt(ein Absatz),## Farben(3-5 Hex-Werte mit Rollen),## Typografie(1-2 Schriftfamilien),## Was NICHT zu tun ist(3-5 Anti-Patterns). - Nichts davon? → Stelle 3 Fragen, bevor du HTML schreibst:
- Was ist die Stimmung? (explosiv / cineastisch / fließend / technisch / chaotisch / warm)
- Heller oder dunkler Hintergrund?
- Gibt es bestimmte Markenfarben, Schriftarten oder visuelle Referenzen? Erstelle dann aus den Antworten eine minimale DESIGN.md.
Jede Komposition muss ihre Palette und Typografie auf eine DESIGN.md, visual-style.md oder explizite Benutzeranweisung zurückführen. Wenn du nach #333, #3b82f6 oder Roboto greifst, hast du diesen Schritt übersprungen.
Befolge für Bewegungsstandards, Größen, Eintrittsmuster und Easing die house-style.md. Der Hausstil regelt WIE sich Dinge bewegen. Die DESIGN.md regelt WIE Dinge aussehen.
Layout vor Animation
Positioniere jedes Element genau dort, wo es sich in seinem am stärksten sichtbaren Moment befinden soll – dem Frame, in dem es vollständig eingetreten, korrekt platziert und noch nicht verlassen wird. Schreibe dies zuerst als statisches HTML+CSS. Noch keine GSAP.
Warum das wichtig ist: Wenn du Elemente in ihrem animierten Startzustand positionierst (außerhalb des Bildschirms, auf 0 skaliert, Deckkraft 0) und sie dann dorthin bewegst, wo du denkst, dass sie landen sollen, rätst du das endgültige Layout. Überlappungen bleiben unsichtbar, bis das Video gerendert wird. Indem du zuerst den Endzustand baust, kannst du Layout-Probleme sehen und beheben, bevor du Bewegung hinzufügst.
Der Prozess
- Identifiziere den Helden-Frame für jede Szene – den Moment, in dem die meisten Elemente gleichzeitig sichtbar sind. Das ist das Layout, das du baust.
- Schreibe statisches CSS für diesen Frame. Der
.scene-content-Container MUSS die gesamte Szene mitwidth: 100%; height: 100%; padding: Npx;mitdisplay: flex; flex-direction: column; gap: Npx; box-sizing: border-boxausfüllen. Verwende Padding, um den Inhalt nach innen zu verschieben – NIEMALSposition: absolute; top: Npxauf einem Inhaltscontainer. Absolut positionierte Inhaltscontainer laufen über, wenn der Inhalt höher als der verbleibende Platz ist. Reserviereposition: absolutenur für Dekorationen. - Füge Eingänge mit
gsap.from()hinzu – animiere VON außerhalb/unsichtbar ZUR CSS-Position. Die CSS-Position ist die Grundwahrheit; der Tween beschreibt den Weg dorthin. - Füge Ausgänge mit
gsap.to()hinzu – animiere ZU außerhalb/unsichtbar VON der CSS-Position.
Beispiel
/* scene-content füllt die Szene, Padding positioniert den Inhalt */
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px;
gap: 24px;
box-sizing: border-box;
}
.title {
font-size: 120px;
}
.subtitle {
font-size: 42px;
}
/* Container füllt jede Szenengröße (1920x1080, 1080x1920 usw.).
Padding positioniert den Inhalt. Flex + Gap handhabt den Abstand. */
FALSCH – hartcodierte Abmessungen und absolute Positionierung:
.scene-content {
position: absolute;
top: 200px;
left: 160px;
width: 1920px;
height: 1080px;
display: flex; /* ... */
}
// Schritt 3: In diese Positionen hinein animieren
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);
// Schritt 4: Von diesen Positionen aus animieren
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);
Wenn Elemente Platz über die Zeit teilen
Wenn Element A den Bereich verlässt, bevor Element B in den gleichen Bereich eintritt, sollten beide korrekte CSS-Positionen für ihre jeweiligen Helden-Frames haben. Die Timeline-Reihenfolge garantiert, dass sie nie visuell koexistieren – aber wenn du den Layout-Schritt überspringst, wirst du den Fall nicht erkennen, dass sie aufgrund eines Timing-Fehlers versehentlich überlappen.
Was als beabsichtigte Überlappung gilt
Geschichtete Effekte (Glühen hinter Text, Schattenelemente, Hintergrundmuster) und gestapelte Z-Designs (Kartenstapel, Tiefenschichten) sind beabsichtigt. Beim Layout-Schritt geht es darum, unbeabsichtigte Überlappungen zu erkennen – zwei Überschriften, die übereinander landen, eine Statistik, die ein Label bedeckt, Inhalt, der aus dem Frame läuft.
Datenattribute
Alle Clips
| Attribut | Erforderlich | Werte |
|---|---|---|
id | Ja | Eindeutige Kennung |
data-start | Ja | Sekunden oder Clip-ID-Referenz ("el-1", "intro + 2") |
data-duration | Erforderlich für img/div/compositions | Sekunden. Video/Audio verwendet standardmäßig die Mediendauer. |
data-track-index | Ja | Ganzzahl. Clips auf derselben Spur können sich nicht überlappen. |
data-media-start | Nein | Versatz innerhalb der Quelle (Sekunden) |
data-volume | Nein | 0-1 (Standard: 1) |
data-track-index beeinflusst nicht die visuelle Überlagerung – verwende CSS z-index.
Kompositions-Clips
| Attribut | Erforderlich | Werte |
|---|---|---|
data-composition-id | Ja | Eindeutige Kompositions-ID |
data-start | Ja | Startzeit (Hauptkomposition: "0" verwenden) |
data-duration | Ja | Hat Vorrang vor der GSAP-Timeline-Dauer |
data-width / data-height | Ja | Pixelabmessungen (1920x1080 oder 1080x1920) |
data-composition-src | Nein | Pfad zur externen HTML-Datei |
Kompositionsstruktur
Unterkompositionen, die über data-composition-src geladen werden, verwenden einen <template>-Wrapper. Eigenständige Kompositionen (die Haupt-index.html) verwenden KEIN <template> – sie setzen das data-composition-id-div direkt in <body>. Die Verwendung von <template> in einer eigenständigen Datei verbirgt den gesamten Inhalt vor dem Browser und unterbricht das Rendering.
Struktur für Unterkompositionen:
<template id="my-comp-template">
<div data-composition-id="my-comp" data-width="1920" data-height="1080">
<!-- Inhalt -->
<style>
[data-composition-id="my-comp"] {
/* eingeschränkte Stile */
}
</style>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
<script>
window.__timelines = window.__timelines || {};
const tl = gsap.timeline({ paused: true });
// Tweens...
window.__timelines["my-comp"] = tl;
</script>
</div>
</template>
Im Root laden: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>
Video und Audio
Video muss muted playsinline sein. Audio ist immer ein separates <audio>-Element:
<video
id="el-v"
data-start="0"
data-duration="30"
data-track-index="0"
src="video.mp4"
muted
playsinline
></video>
<audio
id="el-a"
data-start="0"
data-duration="30"
data-track-index="2"
src="video.mp4"
data-volume="1"
></audio>
Timeline-Vertrag
- Alle Timelines beginnen mit
{ paused: true }– der Player steuert die Wiedergabe - Jede Timeline registrieren:
window.__timelines["<composition-id>"] = tl - Das Framework verschachtelt Unter-Timelines automatisch – NICHT manuell hinzufügen
- Die Dauer kommt von
data-duration, nicht von der GSAP-Timeline-Länge - Niemals leere Tweens erstellen, um die Dauer festzulegen
Regeln (Nicht verhandelbar)
Deterministisch: Kein Math.random(), Date.now() oder zeitbasierte Logik. Verwende einen gesetzten PRNG, wenn du pseudozufällige Werte benötigst (z. B. mulberry32).
GSAP: Nur visuelle Eigenschaften animieren (opacity, x, y, scale, rotation, color, backgroundColor, borderRadius, Transformationen). NIEMALS visibility, display animieren oder video.play()/audio.play() aufrufen.
Animationskonflikte: Niemals dieselbe Eigenschaft auf demselben Element aus mehreren Timelines gleichzeitig animieren.
Kein repeat: -1: Unendlich wiederholte Timelines brechen die Capture-Engine. Berechne die genaue Wiederholungszahl aus der Kompositionsdauer: repeat: Math.ceil(duration / cycleDuration) - 1.
Synchroner Timeline-Aufbau: Timelines niemals innerhalb von async/await, setTimeout oder Promises erstellen. Die Capture-Engine liest window.__timelines synchron nach dem Laden der Seite. Schriftarten werden vom Compiler eingebettet, sodass sie sofort verfügbar sind – kein Warten auf das Laden von Schriftarten erforderlich.
Niemals Folgendes tun:
window.__timelines-Registrierung vergessen- Video für Audio verwenden – immer stummgeschaltetes Video + separates
<audio> - Video innerhalb eines getimten divs verschachteln – einen nicht getimten Wrapper verwenden
data-layer(stattdessendata-track-indexverwenden) oderdata-end(stattdessendata-durationverwenden)- Videoelementabmessungen animieren – einen Wrapper-div animieren
- Play/Pause/Seek auf Medien aufrufen – das Framework besitzt die Wiedergabe
- Einen Container der obersten Ebene ohne
data-composition-iderstellen repeat: -1auf einer Timeline oder einem Tween verwenden – immer endliche Wiederholungen- Timelines asynchron erstellen (innerhalb von
async,setTimeout,Promise) gsap.set()auf Clip-Elementen aus späteren Szenen verwenden – sie existieren zum Zeitpunkt des Seitenladens nicht im DOM. Verwende stattdessentl.set(selector, vars, timePosition)innerhalb der Timeline zum oder nach demdata-start-Zeitpunkt des Clips.<br>im Textinhalt verwenden – erzwungene Zeilenumbrüche berücksichtigen nicht die tatsächliche gerenderte Schriftbreite. Text, der natürlich umbricht + ein<br>erzeugt einen zusätzlichen unerwünschten Umbruch, was zu Überlappungen führt. Lasse Text stattdessen übermax-widthumbrechen. Ausnahme: kurze Anzeigetitel, bei denen jedes Wort bewusst in einer eigenen Zeile steht (z. B. „DER UNSTERBLICHE SPIEL“ bei 130px).
Szenenübergänge (Nicht verhandelbar)
Jede Mehrszenen-Komposition MUSS ALLE diese Regeln befolgen. Eine Verletzung einer einzigen Regel führt zu einer defekten Komposition.
- IMMER Übergänge zwischen den Szenen verwenden. Keine Jump Cuts. Keine Ausnahmen.
- IMMER Eingangsanimationen in jeder Szene verwenden. Jedes Element animiert mit
gsap.from()EIN. Kein Element darf vollständig ausgebildet erscheinen. Wenn eine Szene 5 Elemente hat, benötigt sie 5 Eingangs-Tweens. - NIEMALS Ausgangsanimationen verwenden, außer in der letzten Szene. Das bedeutet: KEIN
gsap.to(), das die Deckkraft auf 0, y außerhalb des Bildschirms, Maßstab auf 0 oder eine andere „Aus“-Animation animiert, bevor ein Übergang ausgelöst wird. Der Übergang IST der Ausgang. Der Inhalt der ausgehenden Szene MUSS zum Zeitpunkt des Übergangsbeginns vollständig sichtbar sein. - Nur letzte Szene: In der letzten Szene können Elemente ausgeblendet werden (z. B. Ausblenden auf Schwarz). Dies ist die EINZIGE Szene, in der
gsap.to(..., { opacity: 0 })erlaubt ist.
FALSCH – Ausgangsanimation vor dem Übergang:
// VERBOTEN – dies entleert die Szene, bevor der Übergang sie verwenden kann
tl.to("#s1-title", { opacity: 0, y: -40, duration: 0.4 }, 6.5);
tl.to("#s1-subtitle", { opacity: 0, duration: 0.3 }, 6.7);
// Der Übergang wird auf einem leeren Frame ausgelöst
RICHTIG – nur Eingang, Übergang behandelt Ausgang:
// Szenen 1 Eingangsanimationen
tl.from("#s1-title", { y: 50, opacity: 0, duration: 0.7, ease: "power3.out" }, 0.3);
tl.from("#s1-subtitle", { y: 30, opacity: 0, duration: 0.5, ease: "power2.out" }, 0.6);
// KEINE Ausgangs-Tweens – Übergang bei 7,2s behandelt den Szenenwechsel
// Szenen 2 Eingangsanimationen
tl.from("#s2-heading", { x: -40, opacity: 0, duration: 0.6, ease: "expo.out" }, 8.0);
Animationsleitplanken
- Versetze die erste Animation um 0,1-0,3 s (nicht t=0)
- Variiere die Easings zwischen den Eingangs-Tweens – verwende mindestens 3 verschiedene Easings pro Szene
- Wiederhole ein Eingangsmuster nicht innerhalb einer Szene
- Vermeide Vollbild-Linearfarbverläufe auf dunklen Hintergründen (H.264-Banding – verwende radial oder einfarbig + lokalisiertes Glühen)
- 60px+ Überschriften, 20px+ Fließtext, 16px+ Datenbeschriftungen für gerendertes Video
font-variant-numeric: tabular-numsauf Zahlenspalten
Wenn keine visual-style.md oder Animationsrichtung angegeben ist, folge der house-style.md für ästhetische Standardeinstellungen.
Typografie und Assets
- Schriftarten: Schreibe einfach die gewünschte
font-familyin CSS – der Compiler bettet unterstützte Schriftarten automatisch ein. Wenn eine Schriftart nicht unterstützt wird, gibt der Compiler eine Warnung aus. - Füge `crossorigin="anonymous"" zu externen Medien hinzu
Für…
[im Interesse der Länge gekürzt]