¿Qué hace Narración Cinemática con Scroll?
Cuándo Usarlo
- Cuando una página debe sentirse como una historia editorial premium que se desarrolla mientras el usuario se desplaza.
- El usuario menciona narración impulsada por scroll, animación vinculada al scroll, pilas de tarjetas fijas, paralaje, texto dividido, precargador o progresión cinemática.
- Un portafolio, estudio, producto o página de aterrizaje necesita revelaciones sección por sección con profundidad en capas.
- La implementación puede usar GSAP, ScrollTrigger y Lenis.
Vocabulario de Efectos
- Narración impulsada por scroll: las secciones se revelan en secuencia mientras se desplaza.
- Animación vinculada al scroll: el progreso está directamente ligado al scroll con
scrub. - Movimiento activado por scroll: la animación comienza cuando una sección entra en el viewport.
- Revelación escalonada: palabras, líneas, tarjetas o elementos entran con pequeños retrasos.
- Revelación progresiva: opacidad, escala, desenfoque, recorte o cambios de posición a lo largo del progreso del scroll.
- Pila de tarjetas fijas: las tarjetas fijas se superponen, escalan y retroceden a medida que llega la siguiente tarjeta.
- Desplazamiento con paralaje: las capas de fondo y primer plano se mueven a diferentes velocidades.
- Cepillado por scroll: la animación sigue la barra de desplazamiento mediante
scrub: trueoscrub: 1. - Tipografía cinética: movimiento de texto dividido enmascarado, generalmente palabra por palabra o línea por línea.
- Precargador: pantalla de carga inicial, barra de progreso y transición de introducción.
Sensación Objetivo
- Sitio web editorial de lujo.
- Portafolio de estudio creativo de alta gama.
- Pulido de movimiento al nivel de Apple.
- Lenguaje de interacción moderno tipo Awwwards.
- Página de aterrizaje cinematográfica e inmersiva.
Evitar:
- Movimiento rebotante, elástico o con resorte.
- Saltos de escala agresivos.
- Efectos llamativos de estilo videojuego.
- Demasiados efectos de scroll simultáneos.
- Secuestro del scroll que hace que la página sea difícil de leer.
Pila Central
npm i gsap lenis
import Lenis from "lenis";
import "lenis/dist/lenis.css";
import { gsap } from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";
gsap.registerPlugin(ScrollTrigger);
const reduceMotion = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
if (!reduceMotion) {
const lenis = new Lenis({
lerp: 0.08,
smoothWheel: true,
wheelMultiplier: 0.9,
});
lenis.on("scroll", ScrollTrigger.update);
gsap.ticker.add((time) => {
lenis.raf(time * 1000);
});
gsap.ticker.lagSmoothing(0);
}
window.addEventListener("load", () => ScrollTrigger.refresh());
Tokens de Movimiento
- Ease de entrada:
power3.outopower4.out. - Escenas cepilladas:
ease: "none"conscrub: 0.8a1.4. - Duración de revelación de texto:
0.8sa1.1s. - Duración de revelación de tarjeta:
0.9sa1.2s. - Escalonamiento de palabras:
0.035sa0.07s. - Escalonamiento de líneas:
0.08sa0.14s. - Escalonamiento de tarjetas:
0.06sa0.1s. - Desplazamiento de revelación:
y: 24a48. - Desenfoque:
4pxa10px, luego0px. - Profundidad de escala de tarjeta fija:
1hasta0.92.
Anatomía de la Página
- Precargador: pantalla negra, barra de progreso, marca/título, desvanecimiento de introducción.
- Hero: paralaje de imagen, revelación de titular enmascarado, sutil señal de scroll.
- Introducción: tipografía cinética palabra por palabra.
- Secciones de la historia: revelaciones de desvanecimiento, desenfoque y recorte activadas por scroll.
- Proyectos recientes: pila de tarjetas fijas con escala y profundidad en capas.
- Galería o prueba: revelaciones horizontales o progresivas cepilladas por scroll.
- Pie de página: revelación con paralaje o transición ascendente lenta.
Patrón de Marcado
<div class="preloader" data-preloader>
<div class="preloader__bar" data-preloader-bar></div>
</div>
<main>
<section class="hero" data-parallax-section>
<img data-parallax-layer data-speed="-0.18" src="/hero.jpg" alt="">
<h1 data-split-reveal>Diseño que se despliega con moderación cinemática.</h1>
</section>
<section data-story-section>
<p data-split-reveal="words">Cada bloque llega con intención silenciosa.</p>
</section>
<section class="project-stack" data-sticky-stack>
<article data-stack-card>Proyecto Uno</article>
<article data-stack-card>Proyecto Dos</article>
<article data-stack-card>Proyecto Tres</article>
</section>
<footer data-footer-parallax>...</footer>
</main>
Secuencia del Precargador
Usa un precargador para establecer el tono cinemático y luego hacer la transición a la revelación del hero.
function initPreloader() {
const loader = document.querySelector("[data-preloader]");
const bar = document.querySelector("[data-preloader-bar]");
if (!loader) return Promise.resolve();
if (reduceMotion) {
loader.remove();
return Promise.resolve();
}
return new Promise((resolve) => {
const tl = gsap.timeline({
defaults: { ease: "power3.out" },
onComplete: () => {
loader.remove();
resolve();
},
});
tl.fromTo(bar, { scaleX: 0, transformOrigin: "left" }, { scaleX: 1, duration: 1.1 })
.to(loader, { yPercent: -100, duration: 0.9, ease: "power4.inOut" }, "+=0.15");
});
}
Revelación de Texto Dividido
Usa contenedores de desbordamiento enmascarados. Evita dividir texto que contenga enlaces o marcado en línea significativo.
function splitWords(element) {
if (element.dataset.splitReady === "true") return;
const text = element.textContent || "";
const parts = text.split(/(\s+)/);
element.textContent = "";
element.setAttribute("aria-label", text.trim());
parts.forEach((part) => {
if (!part.trim()) {
element.appendChild(document.createTextNode(part));
return;
}
const mask = document.createElement("span");
const word = document.createElement("span");
mask.className = "split-word-mask";
word.className = "split-word";
word.textContent = part;
mask.setAttribute("aria-hidden", "true");
mask.appendChild(word);
element.appendChild(mask);
});
element.dataset.splitReady = "true";
}
function initSplitReveals() {
if (reduceMotion) {
gsap.set("[data-split-reveal]", { autoAlpha: 1 });
return;
}
gsap.utils.toArray("[data-split-reveal]").forEach((element) => {
splitWords(element);
const words = element.querySelectorAll(".split-word");
gsap.fromTo(
words,
{ yPercent: 110, autoAlpha: 0, filter: "blur(8px)" },
{
yPercent: 0,
autoAlpha: 1,
filter: "blur(0px)",
duration: 0.95,
ease: "power4.out",
stagger: 0.05,
scrollTrigger: {
trigger: element,
start: "top 82%",
once: true,
},
}
);
});
}
.split-word-mask {
display: inline-block;
overflow: hidden;
vertical-align: top;
}
.split-word {
display: inline-block;
will-change: transform, opacity, filter;
}
Revelaciones Activadas por Scroll
Úsalas para secciones normales. Deben reproducirse una vez y sentirse compuestas, no nerviosas.
function initSectionReveals() {
if (reduceMotion) {
gsap.set("[data-story-section], [data-reveal-item]", { autoAlpha: 1, clearProps: "all" });
return;
}
gsap.utils.toArray("[data-story-section]").forEach((section) => {
const items = section.querySelectorAll("[data-reveal-item]");
const targets = items.length ? items : section.children;
gsap.fromTo(
targets,
{ y: 36, autoAlpha: 0, filter: "blur(8px)" },
{
y: 0,
autoAlpha: 1,
filter: "blur(0px)",
duration: 1,
ease: "power4.out",
stagger: 0.08,
scrollTrigger: {
trigger: section,
start: "top 82%",
once: true,
},
}
);
});
}
Progresión Vinculada al Scroll
Usa líneas de tiempo cepilladas para la progresión cinemática. Mantén la animación cepillada lineal y deja que la posición del scroll haga la temporización.
function initProgressionScenes() {
if (reduceMotion) return;
gsap.utils.toArray("[data-progress-scene]").forEach((scene) => {
const media = scene.querySelector("[data-progress-media]");
const copy = scene.querySelectorAll("[data-progress-copy]");
gsap.timeline({
scrollTrigger: {
trigger: scene,
start: "top top",
end: "+=140%",
scrub: 1.1,
pin: true,
anticipatePin: 1,
},
})
.fromTo(media, { scale: 1.08 }, { scale: 1, ease: "none" })
.fromTo(copy, { autoAlpha: 0, y: 40 }, { autoAlpha: 1, y: 0, stagger: 0.15, ease: "none" }, 0.15);
});
}
Pila de Tarjetas Fijas
Usa position: sticky para el diseño y ScrollTrigger para la escala/profundidad en capas. Las tarjetas anteriores deben retroceder a medida que llegan las siguientes.
[data-sticky-stack] {
position: relative;
}
[data-stack-card] {
position: sticky;
top: 12vh;
transform-origin: center top;
will-change: transform, opacity;
}
function initStickyCardStack() {
if (reduceMotion) return;
gsap.utils.toArray("[data-sticky-stack]").forEach((stack) => {
const cards = gsap.utils.toArray(stack.querySelectorAll("[data-stack-card]"));
cards.forEach((card, index) => {
const nextCard = cards[index + 1];
if (!nextCard) return;
gsap.to(card, {
scale: 0.92 + index * 0.015,
autoAlpha: 0.72,
y: -24,
ease: "none",
scrollTrigger: {
trigger: nextCard,
start: "top 78%",
end: "top 24%",
scrub: true,
invalidateOnRefresh: true,
},
});
});
});
}
Paralaje
Usa paralaje para imágenes de héroe, capas de fondo y revelaciones de pie de página. Mantén la distancia pequeña.
function initParallax() {
if (reduceMotion) return;
gsap.utils.toArray("[data-parallax-layer]").forEach((layer) => {
const speed = Number(layer.dataset.speed || -0.16);
const section = layer.closest("[data-parallax-section]") || layer;
gsap.to(layer, {
y: () => window.innerHeight * speed,
ease: "none",
scrollTrigger: {
trigger: section,
start: "top bottom",
end: "bottom top",
scrub: 1,
invalidateOnRefresh: true,
},
});
});
}
Revelación de pie de página con paralaje:
function initFooterReveal() {
if (reduceMotion) return;
const footer = document.querySelector("[data-footer-parallax]");
if (!footer) return;
gsap.fromTo(
footer,
{ yPercent: -12, autoAlpha: 0.85 },
{
yPercent: 0,
autoAlpha: 1,
ease: "none",
scrollTrigger: {
trigger: footer,
start: "top bottom",
end: "top 45%",
scrub: 1,
},
}
);
}
Orden de Construcción
- Construir la página estática primero.
- Agregar precargador y entrada del hero.
- Agregar revelaciones de texto dividido.
- Agregar revelaciones sección por sección.
- Agregar progresión de pila de tarjetas fijas.
- Agregar capas de paralaje.
- Agregar escenas fijas cepilladas solo donde la historia las necesite.
- Agregar fallbacks de movimiento reducido y táctiles.
- Ejecutar QA del navegador en escritorio y móvil.
Plantilla de Prompt
Crea una página de aterrizaje cinematográfica impulsada por el scroll con desplazamiento suave de Lenis, animaciones GSAP ScrollTrigger, revelaciones de texto escalonadas, progresión de pila de tarjetas fijas, fondos con paralaje, transiciones cepilladas por scroll, narración sección por sección y una animación de precargador inmersiva. Usa profundidad en capas, transiciones de escala, cambios progresivos de opacidad y movimiento suave activado por viewport para una experiencia editorial premium.
Lista de Verificación QA
- El contenido es legible con JavaScript deshabilitado.
- Los usuarios con movimiento reducido ven contenido estático y sin capa de desplazamiento suave.
- Las revelaciones activadas por scroll se reproducen una vez.
- Las escenas vinculadas al scroll usan
scrubintencionalmente. - Las tarjetas fijas no se superponen al pie de página ni bloquean la página.
- El movimiento de paralaje se mantiene sutil y no perjudica la legibilidad.
- El precargador sale de manera confiable incluso si las imágenes cargan lentamente.
ScrollTrigger.refresh()se ejecuta después de cambios de diseño, imágenes y fuentes.- En móvil, el anclaje se simplifica o se elimina si el rendimiento baja.
