Habilidad de Animación al Hacer Scroll
Flujo de trabajo
- Confirmar el estilo de animación, la temporización, y si las animaciones deben ejecutarse una vez o repetirse.
- Proporcionar las keyframes + el fragmento JS del observer y la clase exacta de Tailwind a aplicar.
- Ofrecer solo ajustes enfocados (threshold, rootMargin, duración, retardo, valores de transformación/desenfoque).
Lista de verificación de uso
- Insertar el fragmento JS en el
<head> después de las keyframes.
- Agregar la clase de animación y
animate-on-scroll a los elementos.
- Asegurarse de que el nombre de las keyframes coincida con la referencia de animación de Tailwind.
Disparador IntersectionObserver
<script>
(function () {
const style = document.createElement("style");
style.textContent = `
/* Por defecto: pausado */
.animate-on-scroll { animation-play-state: paused !important; }
/* Activado por JS */
.animate-on-scroll.animate { animation-play-state: running !important; }
`;
document.head.appendChild(style);
const once = true;
if (!window.__inViewIO) {
window.__inViewIO = new IntersectionObserver((entries) => {
entries.forEach((entry) => {
if (entry.isIntersecting) {
entry.target.classList.add("animate");
if (once) window.__inViewIO.unobserve(entry.target);
}
});
}, { threshold: 0.2, rootMargin: "0px 0px -10% 0px" });
}
window.initInViewAnimations = function (selector = ".animate-on-scroll") {
document.querySelectorAll(selector).forEach((el) => {
window.__inViewIO.observe(el);
});
};
document.addEventListener("DOMContentLoaded", () => initInViewAnimations());
})();
</script>
Keyframes
<style>
@keyframes animationIn {
0% {
opacity: 0;
transform: translateY(30px);
filter: blur(8px);
}
100% {
opacity: 1;
transform: translateY(0);
filter: blur(0px);
}
}
</style>
Ejemplo con Tailwind
<div class="animate-on-scroll [animation:animationIn_0.8s_ease-out_0.1s_both]">
...
</div>
Parámetros de personalización
- Disparador: ajustar
threshold y rootMargin para revelaciones más tempranas o tardías.
- Repetición: establecer
once = false para permitir repeticiones al volver a entrar.
- Movimiento: modificar
translateY y blur en las keyframes.
- Temporización: cambiar duración y retardo en el valor de animación de Tailwind.
Errores comunes
- Olvidar incluir las keyframes antes del fragmento JS.
- Usar un nombre de keyframe diferente al de la animación de Tailwind.
- Las animaciones no se ejecutan porque el elemento ya está en el viewport antes de inicializar el observer.
Preguntas para hacer cuando faltan especificaciones
- ¿Las animaciones deben ejecutarse una vez o cada vez que el elemento vuelva a entrar?
- ¿Qué tan antes de entrar al viewport deben comenzar?
- ¿Qué estilo de movimiento (fade, slide, blur, scale) desea?