FrontLaxWeb: parallax y scroll interactivo premium
Este archivo es el "cerebro": el método. Las recetas y los snippets viven en
plantillas/y se leen bajo demanda. Las rutasplantillas/,references/,Designs/yComponents/son relativas a la carpeta de este archivo.
Qué logra este skill
Convertir una landing normal en una web-experiencia: el scroll y el puntero se vuelven el mando de una animación continua. Marca-agnóstico: recibe los colores/tokens de cada proyecto.
Los 7 efectos (el catálogo)
- Smooth scroll (cimiento): Lenis. Base de que todo se sienta premium.
- Parallax de capas: fondos lentos / frente rápido = profundidad.
- Scroll-linked animation: propiedades atadas al % de scroll.
- Scroll-reveal: entrar/animar al aparecer en viewport.
- Sticky / pin: algo se "pega" mientras cambia lo de alrededor (stacking cards).
- Micro-interacciones de puntero: tilt 3D, cursor custom, hover.
- Gestos con springs: arrastrar, soltar, tap: física de resorte interrumpible en vez de transiciones CSS de duración fija. Ver sección propia abajo.
Gestos y springs (fusionado del skill apple-design de Emil Kowalski, WWDC destilado)
Terreno DISTINTO al scroll/parallax de arriba: es la física de tocar y arrastrar algo (un menú, una tarjeta deslizable, un modal, un slider). Los principios más accionables para web (de los 17 originales; el resumen vive en references/recetas-y-matriz.md §4bis):
- Interrumpibilidad, el más importante de los 17: cualquier animación debe poder agarrarse y redirigirse a media transición. Para todo lo que el usuario pueda TOCAR, usar springs (parámetros:
damping/amortiguación +response/velocidad), nuncatransitionCSS de duración fija: un spring siempre sabe animar desde su posición ACTUAL, una transición fija no. - Traspaso de velocidad: al soltar un gesto, la animación sigue a la velocidad del dedo (no arranca de cero), y así evita la "costura" visual. En Motion:
dragMomentum+ velocity delPanInfocomo velocidad inicial del spring. - Rubber-banding: en un límite, resistencia progresiva, nunca un tope seco.
- Consistencia espacial: un panel que entra desde la derecha sale hacia la derecha; ancla el origen (
transform-origin) al elemento que disparó la transición. - Materiales y profundidad: capas translúcidas flotantes (
backdrop-filter: blur()) para jerarquía visual, nunca dos superficies translúcidas apiladas directamente. Sin tarjeta gráfica el modo ligero les quita el desenfoque: su fondo semitransparente tiene que leerse bien solo. - Confirmación cruzada (no receta nueva): su regla "Frame-Level Smoothness" es la MISMA que ya teníamos en Cimientos NO negociables (solo
transform/opacity): dos fuentes independientes llegan a la misma regla, más confianza en ella. - Filosofía de fondo (los 8 fundamentos de Apple): Propósito, Agencia, Responsabilidad, Familiaridad, Flexibilidad, Simplicidad, Oficio, Deleite (consecuencia de acertar los 7 anteriores). Es ethos, no una técnica que se implemente: úsalo para justificar decisiones de diseño ("¿esto tiene propósito o es ruido?"), no como checklist técnico.
✅ Tensión resuelta. El principio #14 de Apple (con prefers-reduced-motion: reduce, sustituir el movimiento por fundidos de opacidad) chocaba de frente con la política de la casa ("todo para todos", ignorar esa preferencia). Ganó una tercera vía: el movimiento no se apaga, se le baja la amplitud. El principio 14 no queda descartado ni copiado: queda incorporado como el caso extremo del mismo dial (--motion-gain: 0 produce justamente una web de solo fundidos), así que no hay dos versiones de cada efecto que mantener. La mecánica completa está en "Política de movimiento de la casa" (sección propia, abajo).
Cimientos NO negociables
- Rendimiento: animar SOLO
transformyopacity(GPU). Nuncatop/left/width/height/margin. Usarwill-changecon criterio,requestAnimationFrame, y evitar layout thrashing. - Sin tarjeta gráfica, modo ligero: toda web nace con la detección del dibujo por software y su modo ligero (sin Lenis, sin desenfoques ni mezclas, 3D con su versión sin 3D). Sección propia abajo.
- Política de movimiento de la casa: OBLIGATORIA en todo proyecto. Tiene sección propia justo aquí abajo, porque es la regla que más se incumple por descuido.
POLÍTICA DE MOVIMIENTO DE LA CASA (OBLIGATORIA)
Todo para todos, con la amplitud justa. Nadie ve una web muerta. Lo que cambia según el visitante no es SI hay movimiento, sino CUÁNTO recorrido tiene. Un solo dial gobierna la web entera: la variable CSS --motion-gain, puesta en <html> por un script del <head>.
| Situación | --motion-gain | Qué ve el visitante |
|---|---|---|
| Por defecto | 1 | La experiencia completa. |
Sistema con prefers-reduced-motion: reduce | 0.25 | El mismo diseño con un cuarto de recorrido: el movimiento se lee como acento, no como cámara. |
URL con ?motion=off | 0 | Se queda quieto todo lo que se movía solo, y se retira la clase motion. Lo que el visitante arrastra con el dedo sigue respondiendo: una tarjeta deslizable que no se desliza no es una interfaz sobria, es una foto rota. Es la válvula de quien no quiere movimiento, no un modo de diseño. |
URL con ?motion=full | 1 forzado | Ignora la preferencia del sistema. Para revisar el trabajo desde un equipo con los efectos de animación de Windows desactivados. |
0.25 es el valor de la casa, ajustable por proyecto si el efecto lo pide, pero nunca 1: si con reduce no cambia nada, no estás aplicando la política.
Las tres reglas del dial
gainmultiplica recorrido: píxeles, escala, rotación, skew. En efectos continuos (marquee, loops) multiplica la velocidad.gainnunca multiplica la opacidad. Un fundido no marea a nadie. Por eso, al bajar el dial, un efecto no se rompe: degrada. La matrioska congain: 0.25sigue contando lo mismo, pero en forma de fundido encadenado en vez de zoom de cámara. Y por eso esta política no obliga a escribir una segunda versión de cada efecto, que es justo lo que costaba el principio 14.gainno escala el movimiento dirigido por el usuario: arrastrar, hover, tilt con el puntero, cursor lerp, springs de gesto. El oído interno no protesta por lo que uno mismo provoca. Escala solo el movimiento no solicitado: parallax, zoom al scroll, matrioska, scrubbing de secuencia, horizontal, velocity skew, marquee.
Y siempre, además
4. Válvula visible. Aparte de ?motion=off, un control alcanzable en la interfaz (basta en el pie). Una válvula que solo existe en la URL no la encuentra quien la necesita.
5. Foco de teclado y anchors intactos, y contenido legible sin JS (progressive enhancement).
Accesibilidad, con rigor (verificado contra WCAG, MDN y web.dev, 2026-08-19):
- Lo que hace CONFORME esta política no es el dial, es la válvula. WCAG 2.3.3 (nivel AAA) exige poder DESACTIVAR el movimiento, no solo reducirlo;
?motion=offes ese mecanismo, y por eso es obligatoria y descubrible. Un dial que solo encoge, sin apagado real, no cumpliría la letra de 2.3.3. 0.25bajoreducees un PUNTO DE PARTIDA, no un absoluto. Lo que marea es el movimiento de gran amplitud (parallax, zoom, translación de gran superficie), no la opacidad ni el desplazamiento pequeño. Regla fina: bajoreduce, ese movimiento grande hay que llevarlo a ~cero o sustituirlo por un fundido, no dejarlo "más pequeño pero presente". Para un reveal de 16 px,0.25sobra; para un parallax de 300 px,0.25todavía marea y hay que ir más abajo o directo a opacidad. Es justo lo que respaldan MDN y web.dev: "remove, reduce OR replace".- WCAG 2.2.2 "Pause, Stop, Hide" (nivel A, OBLIGATORIO, no AAA): toda animación automática en bucle de más de 5 s (marquee, vídeo de fondo, gradiente en movimiento) DEBE tener un control de pausa o stop, y esto el dial NO lo sustituye. Si metes un marquee infinito, lleva su botón de pausa aparte.
Interruptor central (copiar tal cual en el <head>, antes de cualquier CSS de animación):
<script>
(function () {
var h = document.documentElement;
var q = new URLSearchParams(location.search).get('motion');
var reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
var gain = q === 'off' ? 0 : q === 'full' ? 1 : reduce ? 0.25 : 1;
h.style.setProperty('--motion-gain', String(gain));
h.classList.toggle('motion', gain > 0); // compatibilidad: los estados animados cuelgan de html.motion
})();
</script>
En CSS se usa dentro de calc(); en JS se lee una vez y se multiplica:
const GAIN = parseFloat(getComputedStyle(document.documentElement)
.getPropertyValue('--motion-gain')) || 0;
SIN TARJETA GRÁFICA: EL MODO LIGERO (de serie en toda web nueva)
El caso. En un ordenador con la aceleración por hardware apagada (pasa igual en muchos ordenadores viejos o de empresa), tres webs con scroll animado iban a tirones y cloudflare.com fluida. Medido con la CPU 6x y sin gráfica, a 1920x1080, contando lo que llega a la pantalla:
| Web | Antes | Con el modo ligero | cloudflare.com, igual |
|---|---|---|---|
| SaaS (Lenis, cristal, 3D) | 1,7 fotogramas/s, parón de 2,4 s | 27,5 y 0,13 s | 42,6 y 47 ms |
| Portfolio (Lenis, orbes con blur, 3D) | 4,6 y 372 ms | 24,8 y 84 ms | 45,3 y 49 ms |
| Producto (sin Lenis; nubes con blur, grano en overlay, demo de cristal) | 30,1 y 260 ms | 42,6 y 74 ms | 46,5 y 46 ms |
Con gráfica, el modo ligero no se enciende y nada cambia (comprobado píxel a píxel en las tres).
Por qué. Sin gráfica, el procesador hace lo que hacía la tarjeta: los desenfoques, las mezclas, el 3D y componer cada fotograma. Y con Lenis el scroll lo mueve NUESTRO código en cada fotograma: si el hilo principal va a 5 fotogramas por segundo, la página se mueve a 5. El scroll del navegador lo mueve otro hilo y sigue fluido aunque el principal esté ocupado (por eso cloudflare.com va bien: su código va a 2 fotogramas y su pantalla a 86).
1. Detectar (plantillas/react/dibujoPorSoftware.ts, o plantillas/vanilla/modo-ligero.js): se pide un contexto con getContext("webgl2"|"webgl", { failIfMajorPerformanceCaveat: true }); null es dibujo por software. Si da contexto, se suelta en el acto (WEBGL_lose_context). Una vez por visita y después del primer pintado, nunca antes del LCP. ?ligero=1 lo fuerza y ?ligero=0 lo quita; dentro de un <iframe> del mismo origen se mira también la dirección de fuera. En jsdom y en el prerender, se da por hecho que hay gráfica.
2. Solo en ese caso:
- (a) No arrancar Lenis: scroll del navegador, y en su sitio una pieza nativa con la misma cara (
scrollToconsmooth,stop/startconoverflow: hiddenen<html>para los menús,on("scroll"),animatedScroll). Lo hace soloplantillas/react/useLenis.ts(yarrancarScroll()en vanilla). Los anclajes y los menús no llevan unifcada uno. No se cuelga dewindow.lenis: Lenis 1.3 ya guarda ahí sus datos. - (b)
<html data-ligero>y el CSS deplantillas/vanilla/modo-ligero.css:backdrop-filter: none; un halo defilter: blur()pasa a unradial-gradientque ya nace difuminado (a doble tamaño con la propiedadscale, que no pisa eltransformdel parallax); unmix-blend-mode(el grano enoverlay) pasa a mezcla normal con menos opacidad. Se ve casi igual y se sigue moviendo igual. - (c) 3D: CADA
getContextWebGL de la web se pide confailIfMajorPerformanceCaveat: true, y así cae solo en su versión sin 3D, que tiene que existir (una imagen, el logo plano o, si era adorno de fondo, nada). - (d) Las animaciones, NO. La política de la casa no cambia: animaciones para todos, se ajusta la amplitud, no se apagan. Y está medido: en el SaaS de la tabla, quitar el fondo animado o pausar las de CSS no cambiaba nada (de 28 a 29-30 fotogramas); en el producto, las motas y la luz del haz, tampoco. Lo que pesa es (a), (b) y (c).
3. Medir, no suponer (plantillas/medir-scroll-visible.mjs, se lanza desde una carpeta con playwright-core): cuenta los fotogramas que llegan a la pantalla con el scroll movido (emisión de pantalla de Chrome), no los requestAnimationFrame, que con el scroll nativo mienten. Dos medidas, siempre con cloudflare.com al lado en la misma tanda: SIN_GRAFICA=1 node medir-scroll-visible.mjs <url> 3 6 (un ordenador sin gráfica) y sin SIN_GRAFICA con CPU 4 (un portátil normal). Chrome sin pantalla (el de Lighthouse) dibuja CON gráfica: no vale para esto. Para encontrar al culpable, quitar cosas una a una con CSS inyectado (display: none, filter: none, mix-blend-mode: normal) y volver a medir: así salieron las nubes del producto de la tabla (de 0,8 s a 0,35 s hasta el primer fotograma), su grano y su demo, y así se vio que su cristal de la portada y sus motas no pintaban nada.
Rendimiento con gráfica: cinco reglas para cualquier web con scroll animado
Medidas en dos webs reales (en una, de 580 a 355 ms de trabajo en fotogramas lentos a CPU 4x). Ninguna quita ni frena una animación: quitan trabajo que no se veía.
- Nada de
getAnimations()en unanimationend: obliga a recalcular los estilos de toda la página (~50 ms a 4x, a menudo en mitad del scroll). Contar losanimationstartyanimationenddel elemento. - No pausar al hacer scroll las animaciones que solo mueven
transform/opacity: van en el compositor y no ahorra nada, y pausar y reanudar son dos recálculos grandes por cada scroll. - Nada de montar secciones «en un rato libre» mientras se hace scroll: Lenis deja huecos libres entre fotogramas y
requestIdleCallbackcae justo ahí. Esperar a que el scroll pare. - Nada de escribir estilos en cada fotograma del scroll si no cambian (
--bn: 0en cada tar)