Vocabulário de Animação
Este repositório (Asymmetric-al/core)
Esta sobreposição de propriedade do repositório mantém o glossário upstream restrito e compatível com as diretrizes canônicas de frontend do Core. Reconcilie-a após atualizações upstream antes de executar bun run skills:sync.
Gatilhos
- Um usuário descreve um efeito de movimento, mas não sabe seu nome.
- Uma discussão de design ou implementação precisa de vocabulário preciso de animação.
- Não use este skill como padrão de implementação ou revisão.
- Uma solicitação concreta para nomear um efeito de movimento deve ser respondida diretamente. A Resposta Inicial upstream se aplica apenas a uma invocação simples sem pergunta ou tarefa.
Fluxo de Trabalho
- Use o glossário upstream para nomear e desambiguar o efeito.
- Mantenha a resposta concisa e não transforme um pedido de nomeação em trabalho de UI.
- Se implementação ou revisão for necessária, carregue
docs/ai/rules/frontend.mdedocs/ai/skills/anim/SKILL.md; esses contratos do repositório prevalecem.
Checklist
- A resposta lidera com o termo mais preciso do glossário.
- Alternativas próximas são distinguidas sem inventar vocabulário.
- Qualquer conselho de implementação é adiado para as regras de frontend e movimento do Core.
Resposta Inicial
Quando este skill é invocado pela primeira vez sem uma pergunta específica, responda apenas com:
Estou pronto para dar um nome a qualquer efeito de movimento que você descrever. Meu conhecimento vem da filosofia de animação de Emil Kowalski.
Transforme uma descrição vaga de um movimento ou efeito no termo preciso, para que o usuário saiba o que pedir.
Início Rápido
O usuário descreve um efeito de forma imprecisa. Você retorna o(s) termo(s) correspondente(s) neste formato:
**Stagger** — Animar vários itens um após o outro com um pequeno atraso entre cada um, criando uma cascata.
Se vários termos puderem se encaixar, liste a melhor correspondência primeiro, depois 1–2 alternativas com uma nota de uma linha sobre como elas diferem.
Instruções
- Leia pela intenção, não por palavras-chave. Usuários descrevem o que veem ou sentem ("elástico", "desliza", "se desenha sozinho"), não o nome técnico. Mapeie a sensação para o glossário abaixo.
- Cite o glossário textualmente. Suas descrições são autoritativas — use-as como estão, não parafraseie.
- Desambigue termos próximos. Quando dois competirem (Clip-path vs Máscara, Pop in vs Bounce, Transição de elemento compartilhado vs Animação de layout), contraste-os para que o usuário possa escolher.
- Quando nada corresponder exatamente, nomeie o termo mais próximo e diga claramente que é uma aproximação, ou descreva o efeito no vocabulário do glossário (ex.: "isso é um stagger de entradas scale-in").
- Fique dentro deste glossário. Se um termo realmente não estiver aqui, diga isso em vez de inventar um — embora você possa explicar o conceito usando estas palavras.
- Seja conciso. Uma pergunta de nomeação quer um nome, não um ensaio. Comece com o termo; expanda apenas se perguntado.
Exemplos
Exemplo 1 — baseado em sensação Usuário: "Como se chama quando um popover parece crescer a partir do botão em que você clicou, em vez de a partir do seu meio?" Saída:
**Animação com origem consciente** — Um elemento anima a partir de seu gatilho, como um popover crescendo a partir do botão que o abriu em vez de a partir de seu próprio centro, que é o padrão em CSS.
Exemplo 2 — desambiguação Usuário: "Aquela coisa onde uma imagem se transforma em outra imagem." Saída:
**Morph** — Uma forma se transforma suavemente em outra forma, ex. Dynamic Island.
Alternativas próximas:
- **Crossfade** — se elas simplesmente desvanecem uma sobre a outra no mesmo lugar.
- **Transição de elemento compartilhado** — se um elemento viaja e se transforma de uma posição para outra.
Exemplo 3 — sensação física Usuário: "Aquele scroll do iOS que resiste e volta quando você puxa demais." Saída:
**Rubber-banding** — Resistência e retorno elástico quando você arrasta além de um limite (a sensação de overscroll do iOS).
Glossário
Um instantâneo selecionado espelhando a página /vocabulary do projeto; mantenha os dois sincronizados quando um deles mudar.
Entradas & Saídas — como elementos aparecem e desaparecem
- Fade in / Fade out — Elemento aparece ou desaparece alterando a opacidade.
- Slide in — Elemento entra deslizando a partir de fora da tela (esquerda, direita, topo ou fundo).
- Scale in — Elemento cresce de menor para tamanho total ao aparecer, frequentemente combinado com um fade.
- Pop in — Elemento aparece com um leve overshoot, como se quicasse no lugar.
- Reveal — Conteúdo é descoberto gradualmente, geralmente animando um clip-path ou máscara.
- Enter / Exit — A animação que um elemento executa quando é adicionado ou removido da tela.
Sequenciamento & Temporização — coordenando múltiplos elementos ou momentos
- Keyframes — Pontos definidos em uma animação (0%, 50%, 100%) que o navegador preenche os intervalos entre eles.
- Interpolação / Tween — Gerar todos os quadros intermediários entre um valor inicial e final, para que o movimento seja contínuo.
- Stagger — Animar vários itens um após o outro com um pequeno atraso entre cada um, criando uma cascata.
- Orquestração — Temporizar deliberadamente múltiplas animações para que pareçam um movimento coordenado.
- Delay — Tempo antes de uma animação começar.
- Duração — Quanto tempo uma animação leva.
- Fill mode — Se um elemento mantém os estilos de seu primeiro ou último quadro antes de a animação começar ou depois de terminar (ex. forwards).
- Animação em etapas — Uma animação dividida em etapas discretas, como um cronômetro regressivo.
Movimento & Transformações — alterando posição, tamanho ou ângulo de um elemento
- Translate — Mover um elemento ao longo do eixo X ou Y.
- Scale — Tornar um elemento maior ou menor.
- Rotate — Girar um elemento em torno de um ponto.
- Skew — Inclinar um elemento ao longo do eixo X ou Y, distorcendo sua forma retangular.
- Inclinação 3D / Flip — Rotacionar no espaço 3D (rotateX / rotateY) para adicionar profundidade.
- Perspectiva — O quão forte o efeito 3D parece — um valor menor exagera a profundidade, como se o espectador estivesse mais próximo.
- Transform origin — O ponto de ancoragem a partir do qual uma escala ou rotação cresce ou gira.
- Animação com origem consciente — Um elemento anima a partir de seu gatilho, como um popover crescendo a partir do botão que o abriu em vez de a partir de seu próprio centro, que é o padrão em CSS.
Transições Entre Estados — conectando um estado, visualização ou elemento a outro
- Crossfade — Um elemento desvanece enquanto outro desvanece, no mesmo lugar.
- Transição de continuidade — Uma mudança que mantém o usuário orientado conectando visualmente o antes e o depois. Por exemplo, tornar o mesmo retângulo maior e menor.
- Morph — Uma forma se transforma suavemente em outra forma, ex. Dynamic Island.
- Transição de elemento compartilhado — Um elemento viaja e se transforma de uma posição para outra, como uma miniatura se expandindo em um cartão.
- Animação de layout — Quando o tamanho ou posição de um elemento muda, ele anima para o novo local em vez de pular.
- Acordeão / Collapse — Uma seção expande e recolhe suavemente sua altura para mostrar ou ocultar conteúdo.
- Transição com consciência de direção — Conteúdo desliza em uma direção ao avançar e na direção oposta ao voltar, para que a navegação tenha senso de direção.
Scroll — movimento ligado à rolagem ou navegação entre visualizações
- Scroll reveal — Elementos desvanecem ou deslizam para o lugar ao entrar no viewport.
- Animação orientada por scroll — Uma animação cujo progresso está diretamente ligado à posição do scroll.
- Parallax — Fundo e primeiro plano se movem em velocidades diferentes ao rolar, criando profundidade.
- Transição de página — Uma animação que toca ao navegar de uma página ou rota para outra.
- Transição de visualização — O navegador transforma entre dois estados ou páginas, conectando elementos compartilhados.
Feedback & Interação — respondendo às ações do usuário
- Hover effect — Mudança visual quando o cursor passa sobre um elemento.
- Press / Tap feedback — Uma sutil redução de escala quando um elemento é clicado, para que pareça físico.
- Hold to confirm — Um efeito de progresso que preenche enquanto o usuário segura um botão.
- Drag — Mover um elemento ao agarrá-lo, muitas vezes com momentum ao soltar.
- Drag to reorder — Arrastar itens em uma lista para reorganizá-los, enquanto os outros se deslocam para abrir espaço.
- Swipe to dismiss — Arrastar um elemento para fora da tela para fechá-lo, como uma gaveta ou toast.
- Rubber-banding — Resistência e retorno elástico quando você arrasta além de um limite (a sensação de overscroll do iOS).
- Shake / Wiggle — Um tremor rápido de um lado para o outro sinalizando um erro ou entrada rejeitada.
- Ripple — Um círculo se expandindo a partir do ponto de um toque, confirmando o pressionamento.
Easing — como a velocidade muda em uma animação
- Easing — A taxa na qual uma animação acelera ou desacelera.
- Ease-out — Começa rápido, termina devagar. O padrão para a maioria das UIs e qualquer coisa que responda ao usuário.
- Ease-in — Começa devagar, termina rápido. Geralmente evitado; pode parecer lerdo.
- Ease-in-out — Devagar, rápido, devagar. Bom para elementos já na tela que se movem de A para B.
- Linear — Velocidade constante. Evite para UI; reserve para spinners ou marquees.
- Cubic-bezier — Uma curva de easing personalizada que você define para controle preciso.
- Easing assimétrico — Uma curva que acelera e desacelera em taxas diferentes. Parece mais vivo do que uma simétrica.
Animações Spring — movimento baseado em física como alternativa ao easing de duração fixa
- Spring — Movimento impulsionado por física (tensão, massa, amortecimento) em vez de uma duração fixa.
- Stiffness / Tensão — O quão fortemente a mola puxa em direção ao seu alvo. Quanto maior, mais rápida.
- Amortecimento (Damping) — O quão rápido uma mola se estabiliza. Amortecimento menor significa mais quique e oscilação.
- Massa — O quão pesado o elemento animado parece. Mais massa o torna mais lento e mais lerdo.
- Bounce — Uma mola que ultrapassa o alvo e se estabiliza, adicionando ludicidade.
- Duração perceptual — Por quanto tempo uma mola parece terminada, mesmo que continue micro-estabilizando por baixo.
- Momentum — Movimento que carrega velocidade, especialmente após um arrasto ou interrupção.
- Velocidade — O quão rápido e em qual direção um elemento está se movendo. Uma mola carrega isso para a próxima animação quando interrompida, para que um elemento arremessado mantenha sua velocidade.
- Animação interrompível — Uma animação que pode ser redirecionada suavemente em pleno voo em vez de terminar primeiro.
Loop & Movimento Ambiente — animações que rodam por conta própria
- Marquee — Texto ou conteúdo que rola continuamente em loop.
- Loop — Uma animação que se repete, um número definido de vezes ou infinitamente.
- Alternate (yoyo) — Um loop que toca para frente e depois inverte a cada iteração, em vez de pular de volta ao início.
- Orbit — Um elemento circulando em torno de outro em um caminho contínuo.
- Pulse — Uma suave mudança repetitiva de escala ou opacidade para chamar atenção.
- Float — Uma suave deriva contínua para cima e para baixo que faz um elemento estático parecer vivo e sem peso.
- Animação ociosa — Movimento sutil que toca enquanto um elemento está apenas parado, esperando ser interagido.
Polimento & Efeitos — os pequenos toques que separam o bom do excelente
- Blur — Um filtro de desfoque usado para suavizar um elemento ou mascarar pequenas imperfeições.
- Clip-path — Recortar um elemento em uma forma, usado para revelações, máscaras e sliders de antes/depois.
- Máscara — Ocultar ou revelar partes de um elemento usando uma forma ou gradiente — como clip-path, mas com bordas suaves e desbotáveis.
- Slider antes / depois — Um divisor arrastável que varre entre duas imagens sobrepostas para compará-las.
- Desenho de linha — Um caminho SVG que se desenha sozinho, como uma caneta invisível traçando-o.
- Morph de texto — Texto que anima caractere por caractere quando muda, chamando atenção para o novo valor.
- Skeleton / Shimmer — Um placeholder com um brilho móvel mostrado enquanto o conteúdo carrega.
- Number ticker — Dígitos rolando ou contando até um valor.
- Números tabulares — Dígitos de largura fixa para que números não se movam ao mudar. Essencial para tickers, temporizadores e contadores.
- Máquina de escrever — Texto aparecendo um caractere por vez, como se estivesse sendo digitado.
Performance — o que mantém o movimento suave em vez de travado
- Frame rate (FPS) — Quadros desenhados por segundo. 60fps é a base para movimento suave; 120fps em telas mais novas.
- Jank — Travamento visível quando o navegador deixa cair quadros porque não consegue acompanhar a animação.
- Quadro perdido — Um quadro que o navegador perdeu o prazo para desenhar, causando uma pequena parada no movimento.
- Compositing — Deixar a GPU mover ou desvanecer um elemento em sua própria camada sem refazer layout ou pintura.
- will-change — Uma dica CSS de que um elemento está prestes a animar, para que o navegador possa promovê-lo a sua própria camada antecipadamente.
- Layout thrashing — Animar propriedades como width, height, top ou left que forçam o navegador a recalcular o layout a cada quadro, causando jank.
Princípios a Saber — conceitos que orientam quando e como animar
- Animação proposital — O movimento deve servir a uma função — orientar, dar feedback, mostrar relações — não apenas decorar.
- Antecipação — Um pequeno movimento de preparação na direção oposta antes de um movimento, sugerindo o que está prestes a acontecer.
- Follow-through — Partes de um elemento continuam se movendo e se estabilizam ligeiramente após o movimento principal parar, adicionando peso.
- Squash & stretch — Deformar um elemento enquanto ele se move para transmitir peso, velocidade e flexibilidade.
- Percepção de performance — A animação certa faz uma interface parecer mais rápida, mesmo quando não é.
- Frequência de uso — Quanto mais vezes um usuário vê uma animação, mais curta e sutil ela deve ser.
- Consistência espacial — Animar de forma que um elemento mantenha sua identidade e posição entre estados, para que os usuários nunca percam o rastro de onde as coisas foram.
- Aceleração de hardware — Animar transform e opacity permite que a GPU mantenha o movimento suave.
- Movimento reduzido — Respeitar a configuração prefers-reduced-motion do usuário reduzindo ou removendo movimento.