Movimento na landing page
Adicione movimento e 3D a uma landing page que já funciona sem eles. Cada efeito que você adicionar tem um propósito declarado, uma variante de movimento reduzido e um fallback que mantém a página completa. A página antes de você começar é o fallback: se um script falhar, o navegador não tiver um recurso, ou o visitante solicitar menos movimento, eles recebem essa página, não uma página em branco.
Entradas
landing/direction.md, seçãoIntenção de movimento e 3D. Este é o briefing para o seu trabalho. Diznoneou nomeia cada momento e para que ele serve. Implemente o que ele nomeia. Não adicione momentos que ele não nomeia.- A página estática construída por
landing-skills:landing-build, ou qualquer página existente. Ela deve renderizar todo o texto e a ação de conversão com JavaScript desabilitado. Verifique isso primeiro: se não o fizer, corrija isso antes de adicionar movimento, porque toda receita aqui assume que a página estática é o fallback. landing/tokens.cssse presente. Use suas cores em shaders e fallbacks. Coloque tokens de movimento (durações, easings) em sua própria folha de estilo; deixetokens.csscomo a direção de arte o escreveu.
Quando uma entrada estiver faltando:
- Sem
direction.md: pergunte ao usuário o que deve se mover e por quê. Se você não puder perguntar, o padrão énone(veja "Decidindo o que se move"); diga isso em seu resumo. - Sem página estática: pare e construa uma primeiro (
landing-skills:landing-build), ou peça por ela. Movimento em camadas sobre uma página que só existe em JavaScript é como uma cena 3D com falha leva o título e a chamada para ação junto com ela. - A stack: leia
package.json. React (Vite, Next) recebe as variantes React onde uma receita tem uma; todo o resto recebe a variante HTML, CSS e JavaScript puro. Um aplicativo React apenas no cliente (tudo renderizado em um#rootvazio) falha na verificação sem JavaScript por construção: o texto deve estar no HTML primeiro, através de renderização no servidor, pré-renderização ou o padrão de ilha emreferences/webgl-3d.md.
Decidindo o que se move
Comece pela intenção em direction.md. Anote, para cada momento que ele
nomeia: o elemento, o papel (entrada, feedback, vinculado ao scroll, ambiente
ou 3D interativo), e o que o visitante aprende com ele. Se você não conseguir
terminar essa frase, corte o momento.
none é uma resposta válida, muitas vezes a certa, e o padrão quando a
intenção está faltando. Muitas páginas estão completas sem movimento além dos
estados de feedback, especialmente quando fotografias ou texto as carregam;
uma página com quase nenhum movimento não perde nada com isso.
Sob none esta é uma verificação curta, não um trabalho novo.
landing-skills:landing-build já escreve estados de hover, foco, pressionar e
desabilitado e um script de formulário com estados de envio, sucesso e erro.
Abra a página em um navegador e confirme quatro coisas:
- A tabulação mostra um anel de foco visível em cada link, botão e campo.
- Os estados de hover e pressionar respondem em botões e links.
- Após o envio de um formulário, a mensagem de status aparece e recebe foco
(
references/interaction.md, "Feedback de envio de formulário", adiciona isso se estiver faltando). - Nada se move por conta própria: sem reprodução automática, sem loop, sem revelação.
Opcionalmente, adicione temporização aos estados de hover e pressionar
(references/interaction.md, "Estados de hover e pressionar"). Então pare. Se
você não conseguiu abrir um navegador, diga isso e liste cada um dos quatro
como "não executado"; não relate a página como verificada.
Quando a intenção nomeia momentos:
- Um momento emblemático por página. A sequência do herói, a demonstração do produto, o objeto 3D. Todo o resto é mais silencioso do que ele.
- Varie por papel, nunca por seção. Feedback é rápido (100 a 200 ms), entradas são mais lentas, movimento vinculado ao scroll segue o scroll. Aplicar o mesmo fade-up, easing e stagger a cada seção é o padrão mais reconhecível de página gerada, e não ensina nada ao visitante.
- A maior parte do conteúdo não se move. Texto que o visitante está lendo nunca se move: sem parallax em parágrafos, sem revelação que esconde um bloco até que seja scrollado.
- Demonstre, não decore. Movimento que mostra como o produto funciona (uma sequência de estados, uma vista explodida, um antes e depois) ganha seu custo. Movimento que apenas diz "esta página é animada" não ganha.
Leia references/foundations.md antes de escrever qualquer movimento. Ele
contém as durações, easings e a lista de padrões que parecem gerados, cada um
com o que fazer em vez disso.
Ajustando receitas à página
As receitas se anexam à página que existe; elas não reestilizam a página.
- A página estática de
landing-skills:landing-builddeixa um substituto para cada momento que a direção nomeia: uma imagem de pôster ou placeholder rotulado em seu tamanho final. Marque esse elemento comdata-moment="<nome>"(o nome daIntenção de movimento e 3D) se a construção não o fez, e anexe a receita a ele: adicione a classe de contêiner da receita a esse elemento, ou selecione-o pelo atributo. - A seção Código de cada receita abre com uma linha nomeando as classes que
ela adiciona, como novas para esta skill, e as classes da construção que
ela usa inalteradas. Adicione as novas classes; nunca redefina as próprias
classes da construção (
.hero,.hero__title,.button,.section,.splite o resto). Onde uma receita precisar de um layout que o elemento da construção não tem, envolva-o em um novo elemento próprio. - Use os tokens da construção (
--color-*,--space-*,--radius-control) para qualquer cor ou tamanho que uma receita precisar, nunca um novo valor literal.
Escolhendo uma receita
Escolha o degrau mais baixo que produz o efeito: CSS, depois um script
pequeno, depois GSAP ou Motion, depois WebGL. Cada receita tem Use quando,
Evite quando, Código, Movimento reduzido e Custo; receitas 3D
adicionam Fallback.
| Necessidade | Leia |
|---|---|
| Durações, easings, molas, stagger, o que parece gerado | references/foundations.md |
| Entrada do herói, headline de texto dividido, revelação com clip-path ou máscara, contador | references/entrances-text.md |
| Progresso do scroll, entrada vinculada ao scroll, storytelling fixo, seções horizontais ou fixas, scroll suave | references/scroll.md |
| Camadas de profundidade no scroll, profundidade do ponteiro, parallax de imagem ou vídeo, parallax em React | references/parallax.md |
| Temporização de hover e pressionar, feedback de envio de formulário, botão magnético, seguidor de cursor, inclinação, arrasto, dial graduado, transições de visualização | references/interaction.md |
| Objeto 3D para girar, vista explodida no scroll, um contexto para dois estágios separados, modelo glTF, ilha React Three Fiber | references/webgl-3d.md |
| O que importar e deixar de fora, arquivos de decodificador não utilizados na construção, criação de pôsteres, compressão de modelo e texturas | references/webgl-assets.md |
| Caminho de câmera impulsionado por scroll, fundo de shader, partículas, distorção de imagem, WebGPU | references/webgl-effects.md |
| Qual biblioteca, sua licença e tamanho, quando CSS é suficiente | references/libraries.md |
| Variantes de movimento reduzido, fallback de WebGL, pausa, orçamentos, protegendo o herói | references/safety.md |
Para qualquer trabalho 3D ou WebGL, leia references/safety.md primeiro (as
receitas de cena importam seus helpers), depois "Antes de qualquer cena" em
references/webgl-3d.md, então apenas a receita que você precisa.
Trilhos de segurança
Estes valem para todo efeito. references/safety.md tem o código.
- O herói pinta sem JavaScript. Título, lead e chamada para ação estão no HTML e visíveis na primeira pintura. Não comece o título ou imagem do herói com opacidade 0: um elemento com opacidade 0 não é candidato a Largest Contentful Paint até aparecer, então uma entrada longa atrasa o LCP. Carregue código 3D após o evento de load, com uma imagem de pôster em seu lugar até o primeiro quadro ser desenhado.
- Reduza, não delete. A própria declaração da direção sobre movimento
reduzido vence; o que se segue é o padrão. Sob
prefers-reduced-motion: reduce, remova parallax, animação de scroll escovado, loops de reprodução automática e grande deslocamento. Mantenha feedback e fades curtos. Uma cena 3D carrega apenas se for estática e controlada pelo usuário; pulá-la e mostrar os pôsteres é a escolha correta mais simples. Escreva a variante reduzida por efeito, e escute a preferência mudando enquanto a página está aberta. Uma regra global que zera a duração de toda animação é em si um indicador reconhecível. - WebGL é opcional. Verifique um contexto antes de baixar qualquer código 3D. Em React, envolva o canvas em um limite de erro. Lide com a perda de contexto. O fallback é uma imagem real, nunca uma caixa vazia.
- Um canvas. Um segundo contexto WebGL dobra a memória e o trabalho da GPU. Coloque momentos 3D relacionados em um canvas fixo.
- Nada roda fora da tela. Canvases, vídeos e loops param quando fora de vista ou quando a aba está oculta.
- Scroll nunca re-renderiza um framework. Leia a posição do scroll no
loop de quadros ou deixe o CSS dirigi-la. Nenhum
setStatepor evento de scroll ou por quadro. - Anime apenas
transformeopacity. Nuncatop,left,width, ouheight. - Auto-hospede cada ativo. Modelos, decodificadores, mapas de ambiente e fontes vêm de sua origem. Alguns helpers usam CDNs de terceiros por padrão; sobrescreva-os.
- Interação tem um caminho de teclado. Qualquer coisa que o ponteiro possa girar, arrastar ou alternar, o teclado também pode.
Definição de pronto
Verifique cada item em um navegador. Uma ferramenta de navegador é a melhor;
sem uma, use o script de captura de landing-skills:landing-review para
capturas de tela e diga quais verificações você não pôde fazer.
- Cada momento nomeado em
Intenção de movimento e 3Dexiste, e nada mais foi adicionado além de estados de feedback. - Com JavaScript desabilitado: todo o texto e a ação de conversão estão presentes.
- Com movimento reduzido emulado: a página está completa e legível, nada reproduz automaticamente, sem parallax, sem escovado; estados de feedback ainda respondem.
- Com WebGL desabilitado (flag do Chromium
--disable-webgl): o pôster ou imagem estática aparece onde a cena estaria, e o texto do herói e a chamada para ação estão intactos. - O texto do herói está visível antes de qualquer código 3D ter carregado (limite a rede para verificar).
- Nenhuma duas seções compartilham a mesma animação de entrada por padrão; o momento emblemático é o único grande.
- Canvases param de desenhar quando scrollados para fora de vista (Painel de
desempenho, ou um contador de chamadas de desenho como em
references/safety.md). - O painel de rede não mostra nenhuma solicitação a um host de terceiros para ativos 3D.
- Em uma construção de produção, three.js e outro código 3D estão em um chunk que não faz parte do bundle de entrada.
- Teclado: toda rotação, arrasto e alternância funciona com teclas; o foco permanece visível.
O detector de indicadores detect-tells.mjs pertence a
landing-skills:landing-review e é um auxílio opcional. Se estiver
disponível, execute-o na página; ele sinaliza indicadores de nível de padrão,
como atributos de revelação embutidos e a chave de desligamento de movimento
reduzido. A verificação necessária é visual: role a página inteira uma vez com
movimento ligado e uma vez com movimento reduzido, e confirme que cada coisa
em movimento tem o papel que você anotou para ela.
Termine com um breve resumo para o usuário: cada momento adicionado e seu propósito, bibliotecas adicionadas com suas licenças, os ativos ainda necessários (por exemplo, um modelo real para substituir um substituto primitivo, uma imagem de pôster) e qualquer verificação que você não pôde executar.