Communitygithub.com

scroll-video-website

Construye o refina un sitio web donde el desplazamiento nativo controla un video aprobado y coordina transiciones de objetos hacia el contenido de la página. Ideal para entradas cinemáticas basadas en scroll y movimiento fotográfico de objetos, en lugar de simples incrustaciones de video con reproducción automática.

¿Qué es scroll-video-website?

Esta habilidad permite crear experiencias web interactivas donde el desplazamiento (scroll) nativo del navegador controla la reproducción de un video y coordina transiciones de objetos fotográficos hacia el contenido de la página. A diferencia de un video autoplay tradicional, el usuario avanza o retrocede en la narrativa visual mediante el scroll, logrando entradas cinemáticas y movimientos de objetos con apariencia fotográfica. La técnica funciona en cualquier stack web existente (React, Vue, HTML plano, etc.) ya que no requiere librerías de animación específicas. Es ideal para presentaciones de productos, recorridos interiores, galerías de arte u otras historias visuales donde se busca una transición fluida entre una escena animada y el contenido estático de la página. La implementación se basa en un stage sticky, sincronización precisa entre scroll y fotogramas de video (seeking coalesced), manejo de estados reducidos y soporte para entrada híbrida (temporizada + scroll). También incluye pautas para mantener la continuidad visual al reposicionar objetos entre el video y el DOM, así como verificación de accesibilidad y pruebas en múltiples dispositivos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsmanuelarx/creative-web-animation-skills/tree/HEAD/skills/scroll-video-website

Preguntar en tu IA favorita

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

Documentación

Sitio web con video controlado por scroll

Convierte una secuencia visual aprobada en una interacción web responsive y reversible. Reutiliza el stack existente del sitio y los activos aprobados; la técnica no requiere una librería de animación en particular. El sujeto, la trayectoria y el destino son entradas del proyecto. Aplica el flujo de trabajo para presentaciones de productos, revelaciones de interiores, obras de arte u otras historias visuales. Un disco y tocadiscos cayendo son ejemplos, no una escena obligatoria.

Establecer la interacción

Inspecciona la implementación actual, la versión aprobada y los comentarios más recientes del usuario antes de editar. Resuelve a partir de ese contexto:

  • ¿Qué movimiento está en el video y qué objetos se animan por separado en código?
  • ¿El scroll controla el clip completo, o un segmento temporizado deliberado precede al scroll? Sigue el comportamiento seleccionado. Una solicitud de scroll desde el inicio debe funcionar con la primera rueda o toque táctil sin necesidad de un clic de puerta.
  • ¿Dónde se convierte la escena final en contenido de página ordinario? ¿Cómo pueden los visitantes acceder directamente al contenido principal?
  • ¿Qué tamaños y plataformas importan, y qué vista previa debe permanecer disponible?

Si solo se solicitan cambios de temporización o control, no regeneres los medios. Guarda la versión de trabajo actual y crea una alternativa aislada cuando se solicite comparación.

Preparar los medios

Usa el video exacto y los fotogramas fijos de inicio/fin decodificados correspondientes. Preserva la interpretación del color, la relación de aspecto y el archivo fuente. Si la unión en sí misma es incorrecta, corrige la entrega de medios antes de ocultarla con efectos de interacción.

Inspecciona la duración, la tasa de fotogramas, las dimensiones y el comportamiento de búsqueda. Intervalos de fotogramas clave más cortos pueden ayudar al scrubbing; una copia con todos los fotogramas clave puede ser útil para un prototipo local pero puede volverse demasiado grande para el despliegue. Evalúa el derivado en el navegador real y optimiza la entrega por separado. No prescribas una configuración de codificación única para cada clip.

Mantén un póster mientras se cargan los metadatos y los fotogramas. Retén el último tiempo solicitado y aplícalo cuando el video esté listo. Un video faltante o rechazado debe dejar una ruta estática utilizable hacia el contenido.

Mapear el scroll a una línea de tiempo

  1. Usa una pista de scroll nativa y un escenario visual sticky cuando se ajusten al diseño existente. Mantén el documento desplazable inmediatamente si el scroll es el control de entrada. Evita la interceptación de la rueda y la captura táctil solo para simular una barra de desplazamiento.
  2. Divide la historia seleccionada en rangos intencionales, como movimiento del sujeto, revelación de cámara, escena establecida, transferencia de objetos y contenido. Usa solo las fases que sirvan al proyecto; una presentación de producto no necesita incluir una caída o revelación de habitación. Asigna suficiente distancia a eventos breves pero importantes. Mapea cada rango a su progreso de medios o transformación; los segundos del clip no necesitan mapearse uniformemente a píxeles de scroll.
  3. Actualiza desde un requestAnimationFrame programado por eventos de scroll. Lee el diseño al medir, no repetidamente dentro de cada actualización de animación.
  4. Mantén el video pausado para el scrubbing. Coalesce las búsquedas: almacena el último objetivo, no inicies una búsqueda en competencia mientras una está pendiente, y aplica el último objetivo después de seeked. No acumules un backlog de fotogramas obsoletos.
  5. Ajusta los extremos, con una pequeña tolerancia de píxeles para cálculos fraccionarios de viewport. Prueba el primer y último fotograma usando posiciones reales de scroll del navegador.
  6. Haz que el scroll detenido mantenga el estado actual. Invierte cada fase según la interacción elegida, incluyendo la acción de apertura cuando todo el clip está controlado por scroll.
  7. Cancela el viaje programático cuando el visitante proporcione entrada de rueda, táctil o teclas de navegación. Evita que el redimensionamiento y las posiciones de scroll restauradas salten inesperadamente el estado de apertura.

Para una entrada híbrida, define explícitamente qué segmento es temporizado y dónde se detiene el scroll inverso. No introduzcas silenciosamente un segmento temporizado en una experiencia totalmente controlada por scroll.

Mantener objetos fotográficos continuos

Usa un objeto visible a través del movimiento elegido y la transición, cuando sea práctico, como un producto moviéndose hacia su vista de detalle o una obra de arte transfiriéndose a una galería. Si se re-parentaliza en un destino, empareja su posición y proyección antes y después de ese cambio.

Un giro completo de extremo a extremo necesita una rotación 3D que exponga el borde. Una rotación plana en el plano es un movimiento diferente. Un plano texturizado puede ser adecuado para un objeto plano como una impresión o un disco; no lo describas como una escena 3D completamente modelada. Un producto sólido cuyo contorno cambia durante la rotación necesita vistas filmadas/generadas adecuadas o un activo 3D.

Mantén las mediciones de origen y destino en un sistema de coordenadas consistente. No mezcles coordenadas de viewport y documento cuando un escenario es sticky. Vuelve a medir al redimensionar y preserva el progreso significativo. Secuencia las acciones dependientes por su causa física. Por ejemplo, si el destino es un tocadiscos, mantén la aguja levantada hasta que el disco aterrice, luego bájala antes de que comience el estado de reproducción.

Difumina los límites de la escena usando iluminación y geometría de escena coincidentes. Mantén los encabezados y enlaces de contenido legibles en lugar de colocarlos sobre imágenes visualmente recargadas. En un viewport estrecho, deja que el contenido se sitúe debajo del objeto cuando no haya suficiente espacio a su lado.

Preservar el acceso al sitio web

Revela la navegación en el punto elegido de la historia, no solo después de que termine una película larga. Mantén el acceso directo a categorías, saltar, repetir y una ruta de vuelta a la escena. Si los cambios de categoría están destinados a intercambiar el objeto, coordínalo con el contenido seleccionado y cualquier movimiento dependiente; las selecciones rápidas deben establecerse en la última solicitud.

No enfoques un objetivo mientras él o un ancestro esté inerte. Hazlo interactivo primero, luego enfócalo sin un salto de scroll extra. Restaura el foco después de que se cierren los diálogos del proyecto.

Una ruta de movimiento reducido debe mostrar escenas estáticas utilizables sin scrubbing ni giro, incluso al hacer scroll hacia atrás. Mantén el estado de medios fallido persistente para que el scroll inverso no pueda restaurar una superposición rota.

Verificar y entregar

Usa las herramientas del navegador compatibles para probar la entrada real, no solo llamadas a funciones de animación internas:

  • Desde una carga nueva, haz scroll sin hacer clic. Detente a medio camino, continúa, luego invierte hasta la apertura.
  • Inspecciona visualmente la transición video/fotograma fijo y la unión objeto-destino.
  • Alcanza el contenido principal con el objeto animado en el lugar correcto, cuando una transición de objeto sea parte del diseño. Ejercita el cambio de categoría, saltar, repetir y el enfoque del teclado.
  • Verifica los diseños de escritorio y móvil, redimensiona en medio del recorrido, movimiento reducido y un video deliberadamente no disponible.
  • Verifica el desbordamiento horizontal, la carga de medios y los errores de consola. Distingue la emulación del navegador de una prueba en un teléfono físico.

Entrega la URL de revisión, una captura de pantalla útil, la línea base conservada y cualquier límite material de rendimiento o prueba de dispositivo. Mantén un manifiesto conciso que identifique los medios fuente y la temporización. Implementar una revisión local no autoriza por sí mismo la publicación.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados