Communitygithub.com

Défilement Cinématographique Web

Conçoit et construit des expériences web interactives à défilement continu et couplé — incluant des pages de narration cinématographique, des visuels interactifs de manga/éditoriaux, et des vitrines de produits ou pages de vente e-commerce à fort taux de conversion — en utilisant une viewport SVG/CSS collante, une physique de défilement à ressort-lerp, des filtres SVG réactifs et une chorégraphie en 6 étages. À utiliser pour créer des sites de narration déclenchés par le défilement, des révélations de produits de luxe, des vitrines macro-zoom explosées, ou des expériences de vente continues sur une seule page.

Qu'est-ce que Défilement Cinématographique Web ?

Cette compétence permet de construire des expériences web interactives à défilement continu et 60fps, sans dépendance. Elle orchestre chaque couche visuelle (zoom caméra, morphing SVG, dispersion de particules, physique du vent, texte narratif/publicitaire) à l'aide d'une seule coordonnée de défilement normalisée (`position` dans `[0, 1]`). L'architecture repose sur une structure collante à quatre couches à l'intérieur d'une piste de défilement haute : fond/ciel, monde (pièce maîtresse du héros), rail de chapitres continus, et HUD/barre d'appel à l'action. Le développement suit un flux de travail en 5 étapes : choix du mode (narration/manga ou e-commerce), conception du SVG héroïque en couches, câblage de la boucle ressort-lerp avec `requestAnimationFrame`, chorégraphie d'un arc en 6 étapes, et vérification sur plusieurs positions de défilement et tailles d'écran. La compétence documente également les pièges CSS/SVG critiques (transparence, origine de transformation, courbes Bézier, rapport d'aspect, coutures atmosphériques et contraste du texte) et fournit des références et exemples complets.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TuanAnhPhan-pika/cinematic-scroll-skill/tree/main/cinematic-scroll-web

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence de Défilement Cinématographique Web

Construisez des expériences web interactives à défilement continu et 60fps, sans dépendance, où chaque couche visuelle — zoom caméra, morphing SVG, dispersion de particules, physique du vent, et texte narratif/publicitaire — partage une seule coordonnée de défilement normalisée (position dans [0, 1]).

Aperçu de l'Architecture

Chaque page suit une scène collante à quatre couches à l'intérieur d'une piste de défilement haute :

#track (hauteur: 700vh, crée une distance de défilement naturelle)
└── #viewport (position: sticky; top: 0; height: 100vh; overflow: hidden)
    ├── #ciel / couches d'arrière-plan ambiantes (interpolation de couleur et d'ambiance)
    ├── #world (scène isolée : pièce maîtresse du héros, filtres SVG, particules, atmosphère)
    ├── #rail (position: absolute; N chapitres empilés de 100vh traduits en continu)
    └── #texture / HUD (#bar, #meter, #guide, barre CTA collante pour le e-commerce)
  • Ne jamais basculer entre des diapositives discrètes avec seulement des classes. Pilotez #rail via translate3d(0, ${-position * (N - 1) * innerHeight}px, 0) et interpolez toutes les transitions de scène avec smoothstep (smooth(a, b, position)).
  • Gardez #world et #rail non bloquants (pointer-events: none) sauf sur les éléments interactifs explicites (#overlay button, échantillons de variantes, appels à l'action Acheter/Ajouter au panier) qui doivent définir pointer-events: auto et un z-index plus élevé.

Flux de Travail de Construction

  1. Choisissez le Mode de Domaine :
  2. Concevez le SVG Héroïque en Couches :
    • Construisez la pièce maîtresse du héros (personnage, emblème ou produit physique) à l'intérieur d'un seul viewBox normalisé avec des couches <g> nommées afin que des sous-parties individuelles puissent tourner, exploser, zoomer ou changer de couleur indépendamment.
  3. Câblez la Boucle Ressort-Lerp (requestAnimationFrame) :
    • Calculez target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1).
    • Adoucissez position += (target - position) * 0.115 et dérivez la speed lissée et l'impulse bornée (wind) afin qu'un défilement rapide pilote naturellement les tissus, cheveux, particules et filtres de déplacement SVG.
  4. Chorégraphiez l'Arc en 6 Étapes :
    • Mappez 0.00 -> 1.00 à travers 6 sections .chapter de 100vh espacées uniformément (top: 0 à top: 500vh).
    • Associez zoom progressif (scale) et fondus enchaînés de couches (smooth(a, b, position)) avec des cartes .caption concises et un HUD #bar + #meter en haut.
  5. Vérifiez Avant de Livrer :
    • Servez sur HTTP local et testez les positions de défilement 00%, 25%, 50%, 75% et 100%.
    • Confirmez que les superpositions interactives (#enter), les sélecteurs de variantes et les CTA collants restent cliquables (pointer-events: auto).
    • Confirmez zéro erreur dans la console, un contraste de texte lisible sur les éléments focaux lumineux, et un cadrage net aux résolutions de bureau (1280x800) et mobile (390x844).

Pièges CSS & SVG Critiques

Évitez ces modes de défaillance courants lors de la construction de pages SVG lourdes :

  1. CSS #id { opacity: 0 } bloque setAttribute('opacity', ...) : Les sélecteurs d'ID en CSS remplacent les attributs de présentation SVG. Soit omettez opacity: 0 en CSS (utilisez initialement l'attribut SVG opacity="0" + setAttribute('opacity', ...)) soit mettez à jour el.style.opacity en JS.
  2. Les attributs transform SVG ignorent CSS transform-origin : transform-box: fill-box; transform-origin: ... s'applique uniquement au CSS el.style.transform. Pour setAttribute('transform', ...) en SVG, enveloppez explicitement les rotations/échelles autour du centre (cx, cy) : translate(cx cy) rotate(deg) scale(s) translate(-cx -cy).
  3. Utilisez les Courbes de Bézier Cubiques (C) au Lieu de Pointes Dentelées : Pour les cheveux organiques, rubans, tissus, fumée ou traînées liquides, évitez les pointes L triangulaires et les grandes distorsions CSS skewX. Animez les points de contrôle de Bézier cubiques en douceur avec des décalages sinusoïdaux le long de phase et du wind borné.
  4. Verrouillez le Rapport d'Aspect du Conteneur Héroïque sur viewBox : Donnez au conteneur SVG héroïque aspect-ratio: <W>/<H>; height: auto; (au lieu de mélanger des dimensions vw et vh indépendantes) afin que les coordonnées de zoom transform-origin restent verrouillées sur la cible à toutes les tailles d'écran.
  5. Empêchez les Coutures Atmosphériques au Milieu de l'Écran : Ne fermez pas les formes <path> de brouillard/brouillard au milieu de l'écran le long d'une ligne horizontale plate (L1440 490 ... Z) avec un contour visible. Utilisez stroke: none et fermez les bandes de nuages en douceur sous la zone d'affichage ou avec des courbes inférieures ondulantes.
  6. Protégez le Contraste du Texte sur les Zones Focales Lumineuses : Appliquez des ombres portées sombres en couches (text-shadow) sur les grands titres d'affichage et des cartes sombres translucides (backdrop-filter: blur(4px)) sur les légendes afin que le texte reste lisible même lorsqu'il passe sur des lunes brillantes, des lueurs ou des reflets métalliques de produits.

Références & Exemples

  • Moteur Physique & SVG — Mathématiques du ressort-lerp, smooth(), filtres SVG réactifs, rotations concentriques, ondes de Bézier itinérantes, et formules de dispersion de particules.
  • Guide d'Adaptation E-Commerce — Adapter l'arc en 6 chapitres aux lancements de produits, vues explosées, changement de coloris, repères de spécifications, et barres d'achat collantes.
  • Modèle de Départ — Échafaudage propre à défilement continu en 6 étapes prêt pour tout thème.
  • Vitrine de Produit E-Commerce — Démo complète de lancement de produit de luxe / montre fonctionnant avec ce moteur.

Skills associés