Communitygithub.com

Desplazamiento Cinematográfico Web

Diseña y construye experiencias web interactivas de desplazamiento continuo, incluyendo páginas de narración cinematográfica, visuales interactivos estilo manga/editorial, y exhibiciones de productos o páginas de aterrizaje de comercio electrónico de alta conversión, utilizando un viewport SVG/CSS fijo, física de desplazamiento con resorte e interpolación, filtros SVG reactivos y rieles coreografiados de 6 etapas.

¿Qué es Desplazamiento Cinematográfico Web?

Esta habilidad permite a un agente de IA crear experiencias web de desplazamiento continuo y alto rendimiento (60 fps) donde todas las capas visuales (zoom de cámara, morphing SVG, dispersión de partículas, física del viento y texto narrativo/comercial) comparten una única coordenada de desplazamiento normalizada (`posición` en `[0, 1]`). Está diseñada para construir páginas de narración cinematográfica, exhibiciones de productos de lujo, vistas de macro-zoom o páginas de venta de una sola página. La arquitectura utiliza un track de desplazamiento alto (700vh) y un viewport fijo para crear una secuencia de capas: fondo de cielo, un mundo SVG aislado, un riel con 6 capítulos transladados continuamente y una capa HUD. La habilidad se apoya en un bucle de resorte-interpolación (`requestAnimationFrame`) para suavizar el desplazamiento y controlar efectos como el viento y la dispersión de partículas. Es compatible con cualquier navegador moderno y plataforma de desarrollo web, y se basa en el uso de SVG, CSS puro y JavaScript sin dependencias externas. El flujo de trabajo incluye elegir un modo de dominio (narración/manga o exhibición de producto/e-commerce), diseñar un SVG heroico en capas, cablear el bucle de interpolación, coreografiar 6 etapas de progresión y verificar el resultado en múltiples resoluciones.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 #rail mediante translate3d(0, ${-position * (N - 1) * innerHeight}px, 0) e interpola todas las transiciones de escena con smoothstep (smooth(a, b, position)).
  • Mantén #world y #rail sin bloqueo (pointer-events: none) excepto en elementos explícitamente interactivos (#overlay button, muestras de variantes, CTAs de Compra/Carrito), que deben establecer pointer-events: auto y un z-index mayor.

Flujo de Trabajo de Construcción

  1. Elige el Modo de Dominio:
  2. Diseña el SVG Heroico en Capas:
    • Construye la pieza central heroica (personaje, emblema o hardware de producto) dentro de un único viewBox normalizado con capas <g> con nombre, para que las subpartes individuales puedan rotar, explotar, hacer zoom o cambiar de paleta de colores de forma independiente.
  3. Conecta el Bucle de Resorte-Interpolación (requestAnimationFrame):
    • Calcula target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1).
    • Suaviza: position += (target - position) * 0.115 y deriva speed suavizada e impulse acotada (wind) para que el desplazamiento rápido impulse de forma natural la tela, el cabello, las partículas y los filtros de desplazamiento SVG.
  4. Coreografía el Arco de 6 Etapas:
    • Mapea 0.00 -> 1.00 a lo largo de 6 secciones .chapter espaciadas uniformemente de 100vh (top: 0 hasta top: 500vh).
    • Combina el zoom progresivo (scale) y las transiciones de capa (smooth(a, b, position)) con tarjetas .caption concisas y un HUD superior #bar + #meter.
  5. Verifica Antes de Publicar:
    • Sirve a través de HTTP local y prueba las posiciones de desplazamiento 00%, 25%, 50%, 75% y 100%.
    • 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).

Errores Críticos de SVG y CSS

Evita estos modos de fallo comunes al construir páginas con mucho SVG:

  1. CSS #id { opacity: 0 } bloquea setAttribute('opacity', ...): Los selectores de ID en CSS anulan los atributos de presentación SVG. Omite opacity: 0 en CSS (usa el atributo SVG opacity="0" inicialmente + setAttribute('opacity', ...)) o actualiza el.style.opacity en JS.
  2. Los atributos transform de SVG ignoran transform-origin de CSS: transform-box: fill-box; transform-origin: ... solo aplica a el.style.transform de CSS. Para setAttribute('transform', ...) de SVG, envuelve explícitamente las rotaciones/escalas alrededor del centro (cx, cy): translate(cx cy) rotate(deg) scale(s) translate(-cx -cy).
  3. 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 triangulares L y las grandes distorsiones CSS skewX. Anima los puntos de control Bézier cúbicos de forma suave con desplazamientos de onda sinusoidal a lo largo de la phase y el wind acotado.
  4. Bloquea la Relación de Aspecto del Contenedor Heroico con viewBox: Dale al contenedor SVG heroico aspect-ratio: <W>/<H>; height: auto; (en lugar de mezclar dimensiones independientes vw y vh) para que las coordenadas de zoom transform-origin permanezcan fijas en el objetivo en todos los tamaños de pantalla.
  5. 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. Usa stroke: none y cierra las bandas de nubes suavemente por debajo del viewport o con curvas inferiores onduladas.
  6. 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

Skills relacionados