Communitygithub.com

Rolagem Cinematográfica em Web

Projeta e constrói experiências web interativas contínuas acopladas à rolagem — incluindo páginas de narrativa cinematográfica, visuais interativos de mangá/editoriais e showcases de produtos ou landing pages de e-commerce de alta conversão — usando uma viewport SVG/CSS fixa, física de rolagem com spring-lerp, filtros SVG reativos e trilhos coreografados em 6 estágios.

O que é Rolagem Cinematográfica em Web?

Esta skill capacita agentes de IA a criarem experiências web de rolagem contínua e cinematográfica, sem dependências, operando a 60fps. Ela unifica todas as camadas visuais — zoom de câmera, morphing SVG, dispersão de partículas, física de vento e texto narrativo/de vendas — em uma única coordenada de rolagem normalizada (position em [0, 1]). A arquitetura utiliza um contêiner sticky de viewport fixa sobre uma trilha de rolagem alta (700vh), com camadas separadas para fundo, mundo (centro do herói SVG), trilho de capítulos e HUD. A skill oferece dois modos principais: Narrativa/Mangá (seguindo o guia de física e motor SVG) e Showcase de Produtos/E-commerce (seguindo o guia de adaptação para e-commerce). O fluxo de construção envolve projetar um SVG herói com camadas nomeadas, conectar um loop spring-lerp via requestAnimationFrame, coreografar um arco de 6 estágios (mapeando de 0 a 1 através de 6 capítulos de 100vh) e verificar a responsividade em múltiplos viewports. A documentação também aborda armadilhas críticas de SVG e CSS, como conflitos de opacidade, origens de transformação e contraste de texto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TuanAnhPhan-pika/cinematic-scroll-skill/tree/main/cinematic-scroll-web

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 #rail via translate3d(0, ${-position * (N - 1) * innerHeight}px, 0) e interpole todas as transições de cena com smoothstep (smooth(a, b, position)).
  • Mantenha #world e #rail não bloqueantes (pointer-events: none) exceto em elementos interativos explícitos (#overlay button, amostras de variação, CTAs de Comprar/Carrinho) que devem definir pointer-events: auto e z-index mais alto.

Fluxo de Construção

  1. Escolha o Modo de Domínio:
  2. Projete o SVG Herói em Camadas:
    • Construa a peça central herói (personagem, emblema ou hardware de produto) dentro de um único viewBox normalizado com camadas <g> nomeadas para que partes individuais possam girar, explodir, ampliar ou trocar de cor independentemente.
  3. Conecte o Loop Spring-Lerp (requestAnimationFrame):
    • Calcule target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1).
    • Suavize position += (target - position) * 0.115 e derive speed suavizado e impulse limitado (wind) para que a rolagem rápida acione naturalmente tecidos, cabelos, partículas e filtros de deslocamento SVG.
  4. Coreografe o Arco de 6 Estágios:
    • Mapeie 0.00 -> 1.00 através de 6 seções .chapter de 100vh uniformemente espaçadas (top: 0 a top: 500vh).
    • Combine zoom progressivo (scale) e crossfades de camadas (smooth(a, b, position)) com cartões .caption concisos e um HUD com #bar + #meter no topo.
  5. Verifique Antes de Publicar:
    • Sirva sobre HTTP local e teste as posições de rolagem 00%, 25%, 50%, 75% e 100%.
    • 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).

Armadilhas Críticas de SVG e CSS

Evite estes modos de falha comuns ao construir páginas com muitos SVG:

  1. CSS #id { opacity: 0 } bloqueia setAttribute('opacity', ...): Seletores de ID em CSS sobrescrevem atributos de apresentação SVG. Ou omita opacity: 0 no CSS (use o atributo SVG opacity="0" inicialmente + setAttribute('opacity', ...)) ou atualize el.style.opacity em JS.
  2. Atributos transform do SVG ignoram transform-origin do CSS: transform-box: fill-box; transform-origin: ... aplica-se apenas a el.style.transform do CSS. Para setAttribute('transform', ...) do SVG, envolva explicitamente rotações/escalas ao redor do centro (cx, cy): translate(cx cy) rotate(deg) scale(s) translate(-cx -cy).
  3. 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 triangulares L e grandes distorções skewX do CSS. Anime pontos de controle Bézier cúbicos suavemente com offsets de onda senoidal ao longo de phase e wind limitado.
  4. Trave a Proporção do Invólucro Herói para viewBox: Dê ao contêiner SVG herói aspect-ratio: <W>/<H>; height: auto; (em vez de misturar dimensões independentes vw e vh) para que as coordenadas de zoom transform-origin permaneçam fixas no alvo em todos os tamanhos de tela.
  5. 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. Use stroke: none e feche as bandas de nuvem suavemente abaixo da viewport ou com curvas inferiores onduladas.
  6. 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.

Habilidades Relacionadas