Skill de Animação ao Rolar
Fluxo de trabalho
- Confirmar o estilo da animação, o timing e se as animações devem ser executadas uma vez ou repetidas.
- Fornecer os keyframes + o snippet JS do observer e a classe exata do Tailwind a ser aplicada.
- Oferecer ajustes focados apenas (threshold, rootMargin, duração, delay, valores de transform/blur).
Lista de verificação
- Insira o snippet JS no
<head> após os keyframes.
- Adicione a classe de animação e
animate-on-scroll aos elementos.
- Certifique-se de que o nome dos keyframes corresponda à referência de animação do Tailwind.
Gatilho IntersectionObserver
<script>
(function () {
const style = document.createElement("style");
style.textContent = `
/* Padrão: pausado */
.animate-on-scroll { animation-play-state: paused !important; }
/* Ativado pelo 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>
Exemplo com Tailwind
<div class="animate-on-scroll [animation:animationIn_0.8s_ease-out_0.1s_both]">
...
</div>
Opções de personalização
- Gatilho: ajuste
threshold e rootMargin para revelações mais cedo/mais tarde.
- Repetição: defina
once = false para permitir repetições ao reentrar.
- Movimento: ajuste
translateY e blur nos keyframes.
- Timing: altere duração e delay no valor de animação do Tailwind.
Armadilhas comuns
- Esquecer de incluir os keyframes antes do snippet JS.
- Usar um nome de keyframe diferente do referenciado na animação do Tailwind.
- Animações não executando porque o elemento já está visível antes da inicialização do observer.
Perguntas a fazer quando as especificações estiverem incompletas
- As animações devem ser executadas uma vez ou toda vez que o elemento reentrar?
- A que distância antes de entrar no viewport elas devem começar?
- Qual estilo de movimento (fade, slide, blur, escala) você deseja?