Landing motion
Añade movimiento y 3D a una página de aterrizaje que ya funciona sin ellos. Cada efecto que añadas debe tener un propósito declarado, una variante de movimiento reducido y un fallback que deje la página completa. La página antes de empezar es el fallback: si un script falla, un navegador carece de una funcionalidad o el visitante solicita menos movimiento, obtiene esa página, no una en blanco.
Entradas
landing/direction.md, secciónIntención de movimiento y 3D. Este es el resumen de tu trabajo. Indicaninguno, o nombra cada momento y para qué sirve. Implementa lo que nombra. No añadas momentos que no nombre.- La página estática construida por
landing-skills:landing-build, o cualquier página existente. Debe mostrar todo el texto y la acción de conversión con JavaScript desactivado. Verifica eso primero: si no lo hace, arréglalo antes de añadir movimiento, porque cada receta aquí asume que la página estática es el fallback. landing/tokens.csssi está presente. Usa sus colores en los shaders y fallbacks. Pon los tokens de movimiento (duraciones, easing) en tu propia hoja de estilo; dejatokens.csscomo lo escribió la dirección de arte.
Cuando falta una entrada:
- Sin
direction.md: pregunta al usuario qué debería moverse y por qué. Si no puedes preguntar, el valor predeterminado esninguno(ver "Decidir qué se mueve"); dilo en tu resumen. - Sin página estática: detente y construye una primero (
landing-skills:landing-build), o pídela. El movimiento superpuesto en una página que solo existe en JavaScript es cómo una escena 3D fallida arrastra consigo el titular y la llamada a la acción. - El stack: lee
package.json. React (Vite, Next) obtiene las variantes de React donde una receta las tiene; todo lo demás obtiene la variante de HTML, CSS y JavaScript plano. Una aplicación React solo de cliente (todo renderizado en un#rootvacío) falla la verificación sin JavaScript por construcción: el texto debe estar en el HTML primero, mediante renderizado del servidor, prerenderizado o el patrón isla enreferences/webgl-3d.md.
Decidir qué se mueve
Empieza desde la intención en direction.md. Escribe, para cada momento que nombre:
el elemento, el rol (entrada, retroalimentación, vinculado al scroll, ambiental o
3D interactivo) y qué aprende el visitante de él. Si no puedes terminar esa
frase, elimina el momento.
ninguno es una respuesta válida, a menudo la correcta, y el valor predeterminado cuando la
intención falta. Muchas páginas están completas sin movimiento más allá de estados de
retroalimentación, especialmente cuando las fotografías o el texto las sostienen; una página con
casi ningún movimiento no pierde nada por ello.
Bajo ninguno esto es una verificación corta, no un trabajo nuevo. landing-skills:landing-build
ya escribe estados hover, focus, presión y deshabilitado y un script de formulario
con estados de envío, éxito y error. Abre la página en un navegador y
confirma cuatro cosas:
- Tabulación muestra un anillo de enfoque visible en cada enlace, botón y campo.
- Los estados hover y presión responden en botones y enlaces.
- Después de enviar un formulario, aparece el mensaje de estado y toma el foco
(
references/interaction.md, "Retroalimentación de envío de formulario", añade esto si falta). - Nada se mueve por sí solo: sin reproducción automática, sin bucle, sin revelación.
Opcionalmente, añade temporización a los estados hover y presión
(references/interaction.md, "Estados hover y presión"). Luego detente. Si no
pudiste abrir un navegador, dilo y enumera cada uno de los cuatro como "no ejecutado"; no
informes la página como verificada.
Cuando la intención nombra momentos:
- Un momento emblemático por página. La secuencia del héroe, la demostración del producto, el objeto 3D. Todo lo demás es más silencioso que él.
- Varía por rol, nunca por sección. La retroalimentación es rápida (100 a 200 ms), las entradas son más lentas, el movimiento vinculado al scroll sigue el scroll. Aplicar el mismo fade-up, easing y stagger a cada sección es el patrón de página generada más reconocible, y no enseña nada al visitante.
- La mayor parte del contenido no se mueve. El texto que el visitante está leyendo nunca se mueve: sin paralaje en párrafos, sin revelación que oculte un bloque hasta que se desplace hacia él.
- Demuestra, no decores. El movimiento que muestra cómo funciona el producto (una secuencia de estados, una vista explosionada, un antes y después) vale su costo. El movimiento que solo dice "esta página está animada" no lo vale.
Lee references/foundations.md antes de escribir cualquier movimiento. Contiene las
duraciones, easing y la lista de patrones que se leen como generados, cada uno con
qué hacer en su lugar.
Ajustar recetas a la página
Las recetas se adjuntan a la página que existe; no la reestilizan.
- La página estática de
landing-skills:landing-builddeja un sustituto para cada momento que la dirección nombra: una imagen de póster o un marcador de posición etiquetado en su tamaño final. Marca ese elemento condata-moment="<nombre>"(el nombre deIntención de movimiento y 3D) si la construcción no lo ha hecho, y adjunta la receta a él: añade la clase contenedora de la receta a ese elemento, o selecciónalo por el atributo. - Cada sección de Código de una receta comienza con una línea que nombra las clases que añade,
como nuevas para esta skill, y las clases de la construcción que usa sin cambios. Añade
las nuevas clases; nunca redefin las propias de la construcción (
.hero,.hero__title,.button,.section,.split, y el resto). Donde una receta necesite un diseño que el elemento de la construcción no tiene, envuélvelo en un nuevo elemento propio. - Usa los tokens de la construcción (
--color-*,--space-*,--radius-control) para cualquier color o tamaño que necesite una receta, nunca un nuevo valor literal.
Elegir una receta
Elige el escalón más bajo que produzca el efecto: CSS, luego un script pequeño,
luego GSAP o Motion, luego WebGL. Cada receta tiene Usar cuando, Evitar cuando,
Código, Movimiento reducido y Costo; las recetas 3D añaden Fallback.
| Necesidad | Leer |
|---|---|
| Duraciones, easing, springs, stagger, qué se lee como generado | references/foundations.md |
| Entrada de héroe, titular de texto dividido, revelación con clip-path o máscara, contador | references/entrances-text.md |
| Progreso de scroll, entrada vinculada al scroll, narración fija, secciones fijadas o horizontales, scroll suave | references/scroll.md |
| Capas de profundidad en scroll, profundidad de puntero, paralaje de imagen o video, paralaje en React | references/parallax.md |
| Temporización de hover y presión, retroalimentación de envío de formulario, botón magnético, seguidor de cursor, inclinación, arrastre, dial escalonado, transiciones de vista | references/interaction.md |
| Objeto 3D para rotar, vista explosionada en scroll, un contexto para dos etapas separadas, modelo glTF, isla de React Three Fiber | references/webgl-3d.md |
| Qué importar y omitir, archivos de decodificador no utilizados en la construcción, hacer pósters, compresión de modelos y texturas | references/webgl-assets.md |
| Ruta de cámara impulsada por scroll, fondo de shader, partículas, distorsión de imagen, WebGPU | references/webgl-effects.md |
| Qué biblioteca, su licencia y tamaño, cuándo CSS es suficiente | references/libraries.md |
| Variantes de movimiento reducido, fallback de WebGL, pausa, presupuestos, proteger el héroe | references/safety.md |
Para cualquier trabajo 3D o WebGL, lee primero references/safety.md (las recetas
de escena importan sus ayudantes), luego "Antes de cualquier escena" en
references/webgl-3d.md, luego solo la receta que necesitas.
Barreras de seguridad
Estas se aplican a todos los efectos. references/safety.md tiene el código.
- El héroe se pinta sin JavaScript. El titular, el lead y la llamada a la acción están en el HTML y son visibles en la primera pintura. No inicies el titular o la imagen del héroe con opacidad 0: un elemento con opacidad 0 no es candidato a Largest Contentful Paint hasta que se muestre, por lo que una entrada larga retrasa LCP. Carga el código 3D después del evento load, con una imagen de póster en su lugar hasta que se dibuje el primer fotograma.
- Reduce, no elimines. La propia declaración de la dirección sobre movimiento reducido
gana; lo que sigue es el valor predeterminado. Bajo
prefers-reduced-motion: reduce, elimina paralaje, animación de scroll borroso, bucles de reproducción automática y gran desplazamiento. Mantén la retroalimentación y los fundidos cortos. Una escena 3D se carga solo si es estática y controlada por el usuario; saltarla y mostrar los pósters es la opción correcta más simple. Escribe la variante reducida por efecto, y escucha el cambio de preferencia mientras la página está abierta. Una regla global que pone a cero la duración de cada animación es en sí misma una señal reconocida. - WebGL es opcional. Verifica un contexto antes de descargar cualquier código 3D. En React, envuelve el canvas en un límite de error. Maneja la pérdida de contexto. El fallback es una imagen real, nunca un cuadro vacío.
- Un solo canvas. Un segundo contexto WebGL duplica la memoria y el trabajo de GPU. Pon los momentos 3D relacionados en un canvas fijo.
- Nada se ejecuta fuera de pantalla. Los canvases, videos y bucles se detienen cuando están fuera de vista o cuando la pestaña está oculta.
- El scroll nunca vuelve a renderizar un framework. Lee la posición de scroll en el bucle
de fotogramas o deja que CSS lo maneje. Sin
setStatepor evento de scroll o por fotograma. - Anima solo
transformyopacity. Nuncatop,left,width, oheight. - Autoalojamiento de cada recurso. Los modelos, decodificadores, mapas de entorno y fuentes provienen de tu origen. Algunos ayudantes usan CDNs de terceros por defecto; anúlalos.
- La interacción tiene una ruta de teclado. Cualquier cosa que el puntero pueda rotar, arrastrar o alternar, el teclado también puede hacerlo.
Definición de terminado
Verifica cada elemento en un navegador. Una herramienta de navegador es lo mejor; sin una, usa el
script de captura de landing-skills:landing-review para capturas de pantalla y di
qué verificaciones no pudiste hacer.
- Cada momento nombrado en
Intención de movimiento y 3Dexiste, y no se añadió nada más allá de los estados de retroalimentación. - Con JavaScript desactivado: todo el texto y la acción de conversión están presentes.
- Con movimiento reducido emulado: la página está completa y legible, nada se reproduce automáticamente, sin paralaje, sin borroso; los estados de retroalimentación aún responden.
- Con WebGL desactivado (indicador de Chromium
--disable-webgl): el póster o la imagen estática se muestra donde estaría la escena, y el texto del héroe y la llamada a la acción no se ven afectados. - El texto del héroe es visible antes de que se haya cargado cualquier código 3D (limita la red para verificar).
- Ninguna sección comparte la misma animación de entrada por defecto; el momento emblemático es el único grande.
- Los canvases dejan de dibujar cuando se desplazan fuera de vista (panel de Rendimiento, o un
contador de llamadas de dibujo como en
references/safety.md). - El panel de red no muestra ninguna solicitud a un host de terceros para recursos 3D.
- En una compilación de producción, three.js y otro código 3D están en un fragmento que no forma parte del paquete de entrada.
- Teclado: cada rotación, arrastre y alternancia funciona con teclas; el foco se mantiene visible.
El detector de señales detect-tells.mjs pertenece a
landing-skills:landing-review y es una ayuda opcional. Si está disponible,
ejecútalo en la página; marca señales a nivel de patrón como atributos de revelación
estándar y el interruptor de eliminación de movimiento reducido. La verificación requerida es visual:
desplaza toda la página una vez con movimiento activado y una vez con movimiento reducido, y
confirma que cada cosa en movimiento tiene el rol que escribiste para ella.
Termina con un breve resumen para el usuario: cada momento añadido y su propósito, bibliotecas añadidas con sus licencias, los recursos aún necesarios (por ejemplo, un modelo real para reemplazar un sustituto primitivo, una imagen de póster) y cualquier verificación que no pudiste ejecutar.