Scroll motion
Movimento deve explicar estrutura: o que é novo, o que pertence junto, o que olhar em seguida. Animação que não faz nada disso é decoração e custa desempenho, então cada efeito abaixo está ligado a um propósito.
Configuração
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/lenis@1/dist/lenis.min.js"></script>
<script defer src="/js/main.js"></script>
defer impede que os scripts bloqueiem a primeira pintura e ainda os executa em ordem, então main.js (o código abaixo) enxerga gsap. Para produção, fixe versões exatas ([email protected]) ou hospede os arquivos localmente.
gsap.registerPlugin(ScrollTrigger);
const reduce = matchMedia("(prefers-reduced-motion: reduce)").matches;
if (!reduce) {
const lenis = new Lenis({ duration: 1.1, smoothWheel: true });
lenis.on("scroll", ScrollTrigger.update);
gsap.ticker.add((t) => lenis.raf(t * 1000));
gsap.ticker.lagSmoothing(0);
}
Envolva toda animação em if (!reduce) ou use gsap.matchMedia(). Pessoas com distúrbios vestibulares definem essa preferência por um motivo, e o conteúdo deve estar totalmente visível sem movimento.
Escolhendo um efeito
| Propósito | Efeito | Seção de referência |
|---|---|---|
| Anunciar uma nova seção | Revelação de título mascarada | Revelações |
| Mostrar itens que pertencem juntos | Fade-up escalonado | Revelações |
| Adicionar profundidade a imagens | Parallax, revelação com clip-path | Imagens |
| Contar uma sequência | Etapas fixas, linha desenhada | Fixação |
| Mostrar um portfólio | Rolagem horizontal | Fixação |
| Enfatizar um número | Contagem crescente | Detalhes |
| Cobrir carregamento inicial | Pré-carregador | Detalhes |
Código copiável para cada um está em references/snippets.md. Leia-o quando estiver prestes a implementar um efeito; você não precisa dele para planejar.
Regras da casa
- Anime apenas
transformeopacity. Animartop,width,marginoubox-shadowaciona layout ou pintura a cada quadro e causa gagueira em celulares de gama média. - Durações: 0,6 a 1,0s para revelações, 0,2 a 0,3s para hovers. Mais longo parece lento na segunda visita.
- Easing:
power3.outpara entradas,power2.inOutpara transições,nonepara animações rastreadas (scrub fornece o easing). - Stagger: 0,06 a 0,12s. Limite o total: com 12 cartões, escalone os primeiros 6 e agrupe os restantes.
- Reproduza uma vez. Use
once: trueoutoggleActions: "play none none none". Re-animar a cada volta da rolagem é cansativo. - Uma peça central por página. Uma seção fixa ou horizontal é memorável uma vez e exaustiva três vezes.
- Defina estado inicial em JS, não em CSS. Se o script falhar ao carregar, conteúdo oculto por CSS fica escondido para sempre.
- Atualize após mudanças no layout: chame
ScrollTrigger.refresh()depois que fontes e imagens carregarem, ou as posições dos gatilhos se deslocam.
window.addEventListener("load", () => ScrollTrigger.refresh());
document.fonts?.ready.then(() => ScrollTrigger.refresh());
Mobile
- Desabilite fixação e rolagem horizontal abaixo de 768px com
gsap.matchMedia(); empilhe o conteúdo normalmente. - Rolagem suave do Lenis em toque frequentemente luta contra a inércia nativa. Deixe a rolagem por toque nativa (o padrão) a menos que a pessoa insista.
- Reduza as distâncias de parallax pela metade em telas pequenas.
Depuração
- Adicione
markers: truea um ScrollTrigger para ver as linhas de início e fim. - Pulo no início da fixação geralmente significa que o elemento fixo tem um pai com transform ou altura variável.
- Animação dispara cedo demais: imagens acima carregaram tarde. Defina
widtheheightexplícitos nas imagens. - Nada anima: verifique se o plugin está registrado e o seletor corresponde.
Sem GSAP
Para simples fade-ups em um site pequeno, um IntersectionObserver adicionando uma classe mais uma transição CSS é suficiente e economiza cerca de 70 KB. Veja a última seção de references/snippets.md.