Habilidad de Desplazamiento Cinematográfico Web (Scroll-Coupled)
Crea experiencias web interactivas de desplazamiento continuo a 60 fps y sin dependencias, donde cada capa visual (zoom de cámara, morphing SVG, dispersión de partículas, física del viento y texto narrativo/comercial) comparte una única coordenada de desplazamiento normalizada (position en [0, 1]).
Resumen de Arquitectura
Cada página sigue una estructura de capas fijas dentro de un track de desplazamiento alto:
#track (altura: 700vh, crea distancia de desplazamiento natural)
└── #viewport (position: sticky; top: 0; height: 100vh; overflow: hidden)
├── #sky / capas de fondo ambiental (interpolación de color y ambiente)
├── #world (escenario aislado: pieza central heroica, filtros SVG, partículas, atmósfera)
├── #rail (position: absolute; N capítulos apilados de 100vh transladados continuamente)
└── #texture / HUD (#bar, #meter, #guide, barra CTA fija para comercio electrónico)
- Nunca alternes diapositivas discretas solo con clases. Impulsa
#railmediantetranslate3d(0, ${-position * (N - 1) * innerHeight}px, 0)e interpola todas las transiciones de escena con smoothstep (smooth(a, b, position)). - Mantén
#worldy#railsin bloqueo (pointer-events: none) excepto en elementos explícitamente interactivos (#overlay button, muestras de variantes, CTAs de Compra/Carrito), que deben establecerpointer-events: autoy unz-indexmayor.
Flujo de Trabajo de Construcción
- Elige el Modo de Dominio:
- Narración / Manga: Sigue la Guía de Física y Motor SVG y comienza desde starter-template.html.
- Exhibición de Producto / Comercio Electrónico: Sigue la Guía de Adaptación para Comercio Electrónico y estudia ecommerce-product-showcase.html.
- Diseña el SVG Heroico en Capas:
- Construye la pieza central heroica (personaje, emblema o hardware de producto) dentro de un único
viewBoxnormalizado con capas<g>con nombre, para que las subpartes individuales puedan rotar, explotar, hacer zoom o cambiar de paleta de colores de forma independiente.
- Construye la pieza central heroica (personaje, emblema o hardware de producto) dentro de un único
- Conecta el Bucle de Resorte-Interpolación (
requestAnimationFrame):- Calcula
target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1). - Suaviza:
position += (target - position) * 0.115y derivaspeedsuavizada eimpulseacotada (wind) para que el desplazamiento rápido impulse de forma natural la tela, el cabello, las partículas y los filtros de desplazamiento SVG.
- Calcula
- Coreografía el Arco de 6 Etapas:
- Mapea
0.00 -> 1.00a lo largo de 6 secciones.chapterespaciadas uniformemente de100vh(top: 0hastatop: 500vh). - Combina el zoom progresivo (
scale) y las transiciones de capa (smooth(a, b, position)) con tarjetas.captionconcisas y un HUD superior#bar+#meter.
- Mapea
- Verifica Antes de Publicar:
- Sirve a través de HTTP local y prueba las posiciones de desplazamiento
00%,25%,50%,75%y100%. - Confirma que las superposiciones interactivas (
#enter), los selectores de variantes y los CTAs fijos sigan siendo cliqueables (pointer-events: auto). - Confirma cero errores en la consola, contraste de texto legible sobre elementos focales brillantes y encuadre limpio tanto en escritorio (
1280x800) como en móvil (390x844).
- Sirve a través de HTTP local y prueba las posiciones de desplazamiento
Errores Críticos de SVG y CSS
Evita estos modos de fallo comunes al construir páginas con mucho SVG:
- CSS
#id { opacity: 0 }bloqueasetAttribute('opacity', ...): Los selectores de ID en CSS anulan los atributos de presentación SVG. Omiteopacity: 0en CSS (usa el atributo SVGopacity="0"inicialmente +setAttribute('opacity', ...)) o actualizael.style.opacityen JS. - Los atributos
transformde SVG ignorantransform-originde CSS:transform-box: fill-box; transform-origin: ...solo aplica ael.style.transformde CSS. ParasetAttribute('transform', ...)de SVG, envuelve explícitamente las rotaciones/escalas alrededor del centro(cx, cy):translate(cx cy) rotate(deg) scale(s) translate(-cx -cy). - Usa Curvas Bézier Cúbicas (
C) en lugar de Picos Puntiagudos: Para cabello orgánico, cintas, tela, humo o estelas líquidas, evita los picos triangularesLy las grandes distorsiones CSSskewX. Anima los puntos de control Bézier cúbicos de forma suave con desplazamientos de onda sinusoidal a lo largo de laphasey elwindacotado. - Bloquea la Relación de Aspecto del Contenedor Heroico con
viewBox: Dale al contenedor SVG heroicoaspect-ratio: <W>/<H>; height: auto;(en lugar de mezclar dimensiones independientesvwyvh) para que las coordenadas de zoomtransform-originpermanezcan fijas en el objetivo en todos los tamaños de pantalla. - Evita Uniones Atmosféricas en Medio de la Pantalla:
No cierres formas
<path>de niebla/nube a medio camino de la pantalla a lo largo de una línea horizontal plana (L1440 490 ... Z) con un trazo visible. Usastroke: noney cierra las bandas de nubes suavemente por debajo del viewport o con curvas inferiores onduladas. - Protege el Contraste del Texto Sobre Áreas Focales Luminosas:
Aplica sombras oscuras en capas (
text-shadow) en títulos de exhibición grandes y tarjetas oscuras translúcidas (backdrop-filter: blur(4px)) en leyendas, para que el texto siga siendo legible incluso al pasar sobre lunas brillantes, resplandores o destellos metálicos de productos.
Referencias y Ejemplos
- Guía de Física y Motor SVG — Matemáticas de resorte-interpolación,
smooth(), filtros SVG reactivos, rotaciones concéntricas, ondas Bézier viajeras y fórmulas de dispersión de partículas. - Guía de Adaptación para Comercio Electrónico — Adaptación del arco de 6 capítulos para lanzamientos de productos, vistas explotadas, cambio de paletas de colores, destacados de especificaciones y barras de compra fijas.
- Plantilla de Inicio — Andamio limpio de desplazamiento continuo de 6 etapas listo para cualquier tema.
- Exhibición de Producto de Comercio Electrónico — Demostración completa y funcional de lanzamiento de un reloj de lujo / producto hardware construida con este motor.