Skill de Rolagem Cinematográfica Acoplada à Web
Crie experiências web interativas de rolagem contínua, sem dependências e a 60fps, onde cada camada visual — zoom de câmera, morphing SVG, dispersão de partículas, física de vento e texto narrativo/de vendas — compartilha uma única coordenada de rolagem normalizada (position em [0, 1]).
Visão Geral da Arquitetura
Cada página segue um estágio fixo de quatro camadas dentro de uma trilha de rolagem alta:
#track (altura: 700vh, cria distância natural de rolagem)
└── #viewport (position: sticky; top: 0; height: 100vh; overflow: hidden)
├── #sky / camadas de fundo ambiente (interpolação de cor e humor)
├── #world (estágio isolado: peça central herói, filtros SVG, partículas, atmosfera)
├── #rail (position: absolute; N capítulos empilhados de 100vh transladados continuamente)
└── #texture / HUD (#bar, #meter, #guide, barra CTA fixa para e-commerce)
- Nunca alterne slides discretos apenas com classes. Direcione
#railviatranslate3d(0, ${-position * (N - 1) * innerHeight}px, 0)e interpole todas as transições de cena com smoothstep (smooth(a, b, position)). - Mantenha
#worlde#railnão bloqueantes (pointer-events: none) exceto em elementos interativos explícitos (#overlay button, amostras de variação, CTAs de Comprar/Carrinho) que devem definirpointer-events: autoez-indexmais alto.
Fluxo de Construção
- Escolha o Modo de Domínio:
- Narrativa / Mangá: Siga o Motor de Física e SVG e comece a partir do starter-template.html.
- Showcase de Produto / E-commerce: Siga o Guia de Adaptação para E-commerce e estude o ecommerce-product-showcase.html.
- Projete o SVG Herói em Camadas:
- Construa a peça central herói (personagem, emblema ou hardware de produto) dentro de um único
viewBoxnormalizado com camadas<g>nomeadas para que partes individuais possam girar, explodir, ampliar ou trocar de cor independentemente.
- Construa a peça central herói (personagem, emblema ou hardware de produto) dentro de um único
- Conecte o Loop Spring-Lerp (
requestAnimationFrame):- Calcule
target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1). - Suavize
position += (target - position) * 0.115e derivespeedsuavizado eimpulselimitado (wind) para que a rolagem rápida acione naturalmente tecidos, cabelos, partículas e filtros de deslocamento SVG.
- Calcule
- Coreografe o Arco de 6 Estágios:
- Mapeie
0.00 -> 1.00através de 6 seções.chapterde100vhuniformemente espaçadas (top: 0atop: 500vh). - Combine zoom progressivo (
scale) e crossfades de camadas (smooth(a, b, position)) com cartões.captionconcisos e um HUD com#bar+#meterno topo.
- Mapeie
- Verifique Antes de Publicar:
- Sirva sobre HTTP local e teste as posições de rolagem
00%,25%,50%,75%e100%. - Confirme que sobreposições interativas (
#enter), seletores de variantes e CTAs fixas permanecem clicáveis (pointer-events: auto). - Confirme zero erros no console, contraste de texto legível sobre elementos focais brilhantes e enquadramento limpo tanto em desktop (
1280x800) quanto em mobile (390x844).
- Sirva sobre HTTP local e teste as posições de rolagem
Armadilhas Críticas de SVG e CSS
Evite estes modos de falha comuns ao construir páginas com muitos SVG:
CSS #id { opacity: 0 }bloqueiasetAttribute('opacity', ...): Seletores de ID em CSS sobrescrevem atributos de apresentação SVG. Ou omitaopacity: 0no CSS (use o atributo SVGopacity="0"inicialmente +setAttribute('opacity', ...)) ou atualizeel.style.opacityem JS.- Atributos
transformdo SVG ignoramtransform-origindo CSS:transform-box: fill-box; transform-origin: ...aplica-se apenas ael.style.transformdo CSS. ParasetAttribute('transform', ...)do SVG, envolva explicitamente rotações/escalas ao redor do centro(cx, cy):translate(cx cy) rotate(deg) scale(s) translate(-cx -cy). - Use Curvas Bézier Cúbicas (
C) em vez de Cunhas Pontiagudas: Para cabelos orgânicos, fitas, tecidos, fumaça ou rastros líquidos, evite picos triangularesLe grandes distorçõesskewXdo CSS. Anime pontos de controle Bézier cúbicos suavemente com offsets de onda senoidal ao longo dephaseewindlimitado. - Trave a Proporção do Invólucro Herói para
viewBox: Dê ao contêiner SVG heróiaspect-ratio: <W>/<H>; height: auto;(em vez de misturar dimensões independentesvwevh) para que as coordenadas de zoomtransform-originpermaneçam fixas no alvo em todos os tamanhos de tela. - Evite Emendas Atmosféricas no Meio da Tela:
Não feche caminhos de névoa/névoa no meio da tela ao longo de uma linha horizontal plana (
L1440 490 ... Z) com um traço visível. Usestroke: nonee feche as bandas de nuvem suavemente abaixo da viewport ou com curvas inferiores onduladas. - Proteja o Contraste do Texto sobre Áreas Focais Luminosas:
Aplique sombras projetadas escuras em camadas (
text-shadow) em títulos grandes de exibição e cartões escuros translúcidos (backdrop-filter: blur(4px)) em legendas para que o texto permaneça legível mesmo ao passar sobre luas brilhantes, brilhos ou destaques metálicos de produtos.
Referências e Exemplos
- Motor de Física e SVG — Matemática spring-lerp,
smooth(), filtros SVG reativos, rotações concêntricas, ondas Bézier viajantes e fórmulas de dispersão de partículas. - Guia de Adaptação para E-commerce — Adaptando o arco de 6 capítulos para lançamentos de produtos, visualizações explodidas, troca de cores, notas técnicas e barras de compra fixas.
- Template Inicial — Esqueleto limpo de rolagem contínua de 6 estágios pronto para qualquer tema.
- Showcase de Produto para E-commerce — Demonstração completa e funcional de lançamento de produto de luxo (relógio/hardware) construída com este motor.