Landing Motion – Bewegung und 3D für Landing Pages
Füge einer Landing Page, die bereits ohne diese Effekte funktioniert, Bewegung und 3D hinzu. Jeder hinzugefügte Effekt hat einen klar definierten Zweck, eine Variante für reduzierte Bewegung und einen Fallback, der die Seite vollständig nutzbar hält. Die Seite, bevor du begonnen hast, ist der Fallback: Wenn ein Skript fehlschlägt, ein Browser eine Funktion nicht unterstützt oder der Besucher weniger Bewegung wünscht, erhält er diese Seite – keine leere Seite.
Eingaben
landing/direction.md, AbschnittMotion- und 3D-Absicht. Dies ist das Briefing für deine Arbeit. Es gibt entwedernonean oder benennt jeden Moment und seinen Zweck. Setze nur das um, was darin genannt wird. Füge keine nicht genannten Momente hinzu.- Die statische Seite, erstellt von
landing-skills:landing-build, oder eine beliebige bereits vorhandene Seite. Sie muss den gesamten Text und die Conversion-Aktion auch bei deaktiviertem JavaScript anzeigen. Überprüfe das zuerst: Ist das nicht der Fall, behebe es, bevor du Bewegung hinzufügst, denn alle hier beschriebenen Rezepte setzen voraus, dass die statische Seite der Fallback ist. landing/tokens.cssfalls vorhanden. Verwende ihre Farben in Shadern und Fallbacks. Platziere Motion-Tokens (Dauern, Easing) in deinem eigenen Stylesheet; lassetokens.cssso, wie es die Art Direction geschrieben hat.
Wenn eine Eingabe fehlt:
- Keine
direction.md: Frage den Benutzer, was sich bewegen soll und warum. Wenn du nicht fragen kannst, ist die Vorgabenone(siehe „Entscheiden, was sich bewegt“); gib dies in deiner Zusammenfassung an. - Keine statische Seite: Halte an und erstelle zuerst eine (
landing-skills:landing-build) oder frage danach. Bewegung, die auf eine Seite geschichtet wird, die nur in JavaScript existiert, führt dazu, dass ein fehlgeschlagener 3D-Szene die Überschrift und den Call-to-Action mit sich reißt. - Der Stack: Lese
package.json. React (Vite, Next) erhält die React-Varianten, falls ein Rezept eine davon hat; alles andere erhält die Variante mit einfachem HTML, CSS und JavaScript. Eine reine Client-React-App (alles in ein leeres#rootgerendert) besteht den No-JavaScript-Check von Natur aus nicht: Der Text muss zuerst im HTML stehen, durch Server-Rendering, Pre-Rendering oder das Island-Muster inreferences/webgl-3d.md.
Entscheiden, was sich bewegt
Beginne mit der Absicht in direction.md. Schreibe für jeden darin genannten Moment auf: das Element, die Rolle (Eingang, Feedback, scrollgebunden, ambient oder interaktiv 3D) und was der Besucher daraus lernt. Wenn du diesen Satz nicht zu Ende führen kannst, streiche den Moment.
none ist eine gültige Antwort, oft die richtige, und die Vorgabe, wenn die Absicht fehlt. Viele Seiten sind ohne Bewegung jenseits von Feedback-Zuständen vollständig, besonders wenn Fotos oder Text sie tragen; eine Seite mit fast keiner Bewegung verliert dadurch nichts.
Bei none handelt es sich um eine kurze Überprüfung, nicht um neue Arbeit. landing-skills:landing-build schreibt bereits Hover-, Fokus-, Drück- und Deaktiviert-Zustände sowie ein Formularskript mit Senden-, Erfolgs- und Fehlerzuständen. Öffne die Seite in einem Browser und bestätige vier Dinge:
- Durch Tabben wird ein sichtbarer Fokusring auf jedem Link, Button und Feld angezeigt.
- Hover- und Drück-Zustände reagieren auf Buttons und Links.
- Nach einem Formularabsenden erscheint die Statusmeldung und erhält den Fokus (
references/interaction.md, „Formular-Senden-Feedback“, fügt dies hinzu, falls es fehlt). - Nichts bewegt sich von selbst: kein Autoplay, keine Schleife, keine Einblendung.
Optional kannst du den Hover- und Drück-Zuständen Timing hinzufügen (references/interaction.md, „Hover- und Drück-Zustände“). Höre dann auf. Wenn du keinen Browser öffnen konntest, sage dies und liste jeden der vier Punkte als „nicht ausgeführt“ auf; melde die Seite nicht als geprüft.
Wenn die Absicht Momente benennt:
- Ein signifikanter Moment pro Seite. Die Hero-Sequenz, die Produktdemo, das 3D-Objekt. Alles andere ist leiser als dieser.
- Variiere nach Rolle, niemals nach Abschnitt. Feedback ist schnell (100 bis 200 ms), Eingänge sind langsamer, scrollgebundene Bewegung folgt dem Scrollen. Denselben Fade-Up, dasselbe Easing und denselben Stagger auf jeden Abschnitt anzuwenden, ist das erkennbarste generierte Seitenmuster und lehrt den Besucher nichts.
- Der meiste Inhalt bewegt sich nicht. Text, den der Besucher liest, bewegt sich nie: kein Parallax auf Absätzen, keine Einblendung, die einen Block verbirgt, bis zu ihm gescrollt wird.
- Demonstrieren, nicht dekorieren. Bewegung, die zeigt, wie das Produkt funktioniert (eine Abfolge von Zuständen, eine Explosionszeichnung, ein Vorher-Nachher), ist ihren Aufwand wert. Bewegung, die nur sagt „diese Seite ist animiert“, ist es nicht.
Lese references/foundations.md, bevor du irgendeine Bewegung schreibst. Es enthält die Dauern, Easings und die Liste der Muster, die als generiert gelten, jeweils mit dem, was stattdessen zu tun ist.
Rezepte an die Seite anpassen
Rezepte heften sich an die vorhandene Seite an; sie gestalten sie nicht neu.
- Die statische Seite von
landing-skills:landing-buildhinterlässt einen Platzhalter für jeden Moment, den die direction.md nennt: ein Posterbild oder einen beschrifteten Platzhalter in seiner endgültigen Größe. Markiere dieses Element mitdata-moment="<Name>"(der Name aus „Motion- und 3D-Absicht“), falls der Build es nicht getan hat, und befestige das Rezept daran: Füge die Container-Klasse des Rezepts zu diesem Element hinzu oder wähle es über das Attribut aus. - Jeder Code-Abschnitt eines Rezepts beginnt mit einer Zeile, die die neuen Klassen benennt, zusammen mit den Build-Klassen, die es unverändert verwendet. Füge die neuen Klassen hinzu; definiere niemals die eigenen Build-Klassen neu (
.hero,.hero__title,.button,.section,.splitund die anderen). Wo ein Rezept ein Layout benötigt, das das Build-Element nicht hat, umschließe es mit einem neuen eigenen Element. - Verwende die Tokens des Builds (
--color-*,--space-*,--radius-control) für jede Farbe oder Größe, die ein Rezept benötigt, niemals einen neuen Literalwert.
Ein Rezept auswählen
Wähle die niedrigste Stufe, die den Effekt erzeugt: CSS, dann ein kleines Skript, dann GSAP oder Motion, dann WebGL. Jedes Rezept hat „Verwenden, wenn“, „Vermeiden, wenn“, „Code“, „Reduzierte Bewegung“ und „Kosten“; 3D-Rezepte fügen „Fallback“ hinzu.
| Bedarf | Lese dies |
|---|---|
| Dauern, Easings, Federn, Stagger, was als generiert gilt | references/foundations.md |
| Hero-Eingang, Split-Text-Überschrift, Clip-Path- oder Mask-Enthüllung, Zähler | references/entrances-text.md |
| Scroll-Fortschritt, scrollgebundener Eingang, Storytelling mit Sticky, horizontale oder angeheftete Abschnitte, Smooth Scroll | references/scroll.md |
| Tiefenebenen beim Scrollen, Zeiger-Tiefe, Bild- oder Video-Parallax, Parallax in React | references/parallax.md |
| Hover- und Drück-Timing, Formular-Senden-Feedback, Magnet-Button, Cursor-Follower, Neigen, Ziehen, ein gestufter Regler, View-Transitionen | references/interaction.md |
| 3D-Objekt zum Drehen, Explosionszeichnung beim Scrollen, ein Kontext für zwei getrennte Phasen, glTF-Modell, React Three Fiber Island | references/webgl-3d.md |
| Was importieren und weglassen, ungenutzte Decoder-Dateien im Build, Poster erstellen, Modellkomprimierung und Texturen | references/webgl-assets.md |
| Scrollgesteuerte Kamerafahrt, Shader-Hintergrund, Partikel, Bildverzerrung, WebGPU | references/webgl-effects.md |
| Welche Bibliothek, ihre Lizenz und Größe, wann CSS ausreicht | references/libraries.md |
| Varianten für reduzierte Bewegung, WebGL-Fallback, Pausieren, Budgets, Schutz des Hero | references/safety.md |
Lies für jede 3D- oder WebGL-Arbeit zuerst references/safety.md (die Szenen-Rezepte importieren ihre Hilfsfunktionen), dann „Vor jeder Szene“ in references/webgl-3d.md und dann nur das Rezept, das du benötigst.
Sicherheitsregeln
Diese gelten für jeden Effekt. references/safety.md enthält den Code.
- Der Hero wird ohne JavaScript gerendert. Überschrift, Lead und Call-to-Action sind im HTML und beim ersten Paint sichtbar. Beginne die Überschrift oder das Hero-Bild nicht mit Opacity 0: Ein Element mit Opacity 0 ist kein Kandidat für den Largest Contentful Paint, bis es sichtbar wird, daher verzögert ein langer Eingang LCP. Lade 3D-Code erst nach dem Ladeereignis, mit einem Posterbild an seiner Stelle, bis der erste Frame gezeichnet ist.
- Reduzieren, nicht löschen. Die eigene Aussage der direction.md zur reduzierten Bewegung hat Vorrang; was folgt, ist die Vorgabe. Bei
prefers-reduced-motion: reduceentferne Parallax, berechnete Scroll-Animation, Autoplay-Schleifen und große Bewegungen. Behalte Feedback und kurze Einblendungen bei. Eine 3D-Szene wird nur geladen, wenn sie statisch und benutzergesteuert ist; sie zu überspringen und die Poster zu zeigen, ist die einfachste richtige Wahl. Schreibe die reduzierte Variante pro Effekt und höre auf die Präferenzänderung, während die Seite geöffnet ist. Eine globale Regel, die die Dauer jeder Animation auf Null setzt, ist selbst ein erkennbares Tell. - WebGL ist optional. Prüfe auf einen Kontext, bevor du 3D-Code herunterlädst. Ummantle in React das Canvas mit einer Error Boundary. Behandle Kontextverlust. Der Fallback ist ein echtes Bild, niemals eine leere Box.
- Ein Canvas. Ein zweiter WebGL-Kontext verdoppelt Speicher- und GPU-Arbeit. Setze zusammengehörige 3D-Momente in ein einziges Sticky-Canvas.
- Nichts läuft außerhalb des Bildschirms. Canvases, Videos und Schleifen stoppen, wenn sie nicht sichtbar sind oder der Tab verborgen ist.
- Scroll rendert niemals ein Framework neu. Lese die Scroll-Position im Frame-Loop oder lasse CSS sie steuern. Kein
setStatepro Scroll-Ereignis oder pro Frame. - Animiere nur
transformundopacity. Niemalstop,left,widthoderheight. - Hoste jedes Asset selbst. Modelle, Decoder, Umgebungsmaps und Schriftarten kommen von deiner eigenen Domain. Einige Hilfsfunktionen verwenden standardmäßig Drittanbieter-CDN; überschreibe sie.
- Interaktion hat einen Tastaturpfad. Alles, was der Zeiger drehen, ziehen oder umschalten kann, kann die Tastatur auch.
Definition von „Fertig“
Überprüfe jeden Punkt in einem Browser. Ein Browser-Tool ist am besten; ohne eines verwende das Capture-Skript von landing-skills:landing-review für Screenshots und sage, welche Überprüfungen du nicht durchführen konntest.
- Jeder in „Motion- und 3D-Absicht“ genannte Moment existiert, und es wurde nichts anderes über Feedback-Zustände hinaus hinzugefügt.
- Bei deaktiviertem JavaScript: Der gesamte Text und die Conversion-Aktion sind vorhanden.
- Bei emulierter reduzierter Bewegung: Die Seite ist vollständig und lesbar, nichts spielt automatisch ab, kein Parallax, keine Berechnung; Feedback-Zustände reagieren weiterhin.
- Bei deaktiviertem WebGL (Chromium-Flag
--disable-webgl): Das Poster oder statische Bild wird dort angezeigt, wo die Szene sein sollte, und der Hero-Text und der Call-to-Action sind unberührt. - Der Hero-Text ist sichtbar, bevor 3D-Code geladen ist (Netzwerk drosseln, um zu überprüfen).
- Keine zwei Abschnitte teilen standardmäßig dieselbe Eingangsanimation; der signifikante Moment ist der einzige große.
- Canvases hören auf zu zeichnen, wenn aus dem sichtbaren Bereich gescrollt wird (Performance-Panel oder ein Draw-Call-Zähler wie in
references/safety.md). - Das Netzwerk-Panel zeigt keine Anfrage an einen Drittanbieter-Host für 3D-Assets.
- In einem Production-Build befinden sich three.js und anderer 3D-Code in einem Chunk, der nicht Teil des Entry-Bundles ist.
- Tastatur: Jedes Drehen, Ziehen und Umschalten funktioniert mit Tasten; der Fokus bleibt sichtbar.
Der Tell-Detektor detect-tells.mjs gehört zu landing-skills:landing-review und ist eine optionale Hilfe. Wenn verfügbar, führe ihn auf der Seite aus; er erkennt Tell auf Muster-Ebene wie Standard-Reveal-Attribute und den Reduced-Motion-Kill-Switch. Die erforderliche Überprüfung erfolgt mit dem Auge: Scrolle die gesamte Seite einmal mit eingeschalteter Bewegung und einmal mit reduzierter Bewegung und bestätige, dass jedes sich bewegende Ding die Rolle hat, die du dafür notiert hast.
Beende mit einer kurzen Zusammenfassung für den Benutzer: Jeder hinzugefügte Moment und sein Zweck, hinzugefügte Bibliotheken mit ihren Lizenzen, die noch benötigten Assets (z. B. ein echtes Modell, um einen primitiven Platzhalter zu ersetzen, ein Posterbild) und jede Überprüfung, die du nicht durchführen konntest.