{"id":843,"date":"2026-11-16T18:32:28","date_gmt":"2026-11-16T21:32:28","guid":{"rendered":"https:\/\/yellowkode.com\/blog\/animation-range-start-escalonar-animacoes-scroll\/"},"modified":"2026-11-16T18:32:28","modified_gmt":"2026-11-16T21:32:28","slug":"animation-range-start-escalonar-animacoes-scroll","status":"publish","type":"post","link":"https:\/\/yellowkode.com\/blog\/animation-range-start-escalonar-animacoes-scroll\/","title":{"rendered":"Usando animation-range-start para escalonar anima\u00e7\u00f5es por scroll"},"content":{"rendered":"<p>Este artigo aborda uma linha de CSS que resolve um problema frequentemente abordado em tutoriais com f\u00f3rmulas extensas. O destaque n\u00e3o \u00e9 apenas a propriedade em si, mas o que ela revela sobre a efici\u00eancia de utilizar recursos nativos do navegador.<\/p>\n<h2>O que aconteceu<\/h2>\n<p>Em 16 de novembro de 2026, Lee Meyer publicou no CSS-Tricks um artigo intitulado <em>Staggering Scroll-Driven Animations with animation-range-start<\/em>. Este artigo responde a uma proposta anterior do Master.dev, que sugeria uma f\u00f3rmula gen\u00e9rica para escalonar anima\u00e7\u00f5es baseadas em qualquer input de progresso, incluindo scroll. Meyer aponta que, para o caso de scroll, o CSS moderno j\u00e1 oferece uma ferramenta eficiente em uma \u00fanica linha de c\u00f3digo.<\/p>\n<p>A propriedade em quest\u00e3o \u00e9 <code>animation-range-start<\/code>, introduzida para atrasar anima\u00e7\u00f5es baseadas em scroll conforme o progresso da rolagem, n\u00e3o do tempo. Antes dela, o uso de <code>animation-delay<\/code> em anima\u00e7\u00f5es driven por scroll era ineficaz, pois <code>animation-delay<\/code> opera em unidades de tempo, enquanto a timeline aqui \u00e9 definida por posi\u00e7\u00e3o.<\/p>\n<h2>Como funciona por baixo<\/h2>\n<h3>Scroll timeline n\u00e3o \u00e9 tempo<\/h3>\n<p>Uma anima\u00e7\u00e3o CSS tradicional opera com base em um rel\u00f3gio, avan\u00e7ando keyframes conforme o tempo passa. Em uma anima\u00e7\u00e3o driven por scroll, esse rel\u00f3gio \u00e9 substitu\u00eddo por uma r\u00e9gua que mede o quanto o usu\u00e1rio rolou na p\u00e1gina ou quanto um elemento atravessou o viewport, com 0% sendo o in\u00edcio e 100% o fim.<\/p>\n<p>Essa mudan\u00e7a invalida o uso de <code>animation-delay<\/code> em anima\u00e7\u00f5es driven por scroll. Para isso, existe um par espec\u00edfico: <code>animation-range<\/code>, que \u00e9 uma shorthand para <code>animation-range-start<\/code> e <code>animation-range-end<\/code>, aceitando porcentagens ou ranges nomeados como <code>entry<\/code>, <code>contain<\/code>, <code>cover<\/code> e <code>exit<\/code>.<\/p>\n<h3>Os ranges nomeados<\/h3>\n<p>Os ranges nomeados correspondem a fases da travessia de um elemento pelo viewport. <code>entry<\/code> \u00e9 quando o elemento come\u00e7a a aparecer; <code>contain<\/code> \u00e9 quando est\u00e1 totalmente vis\u00edvel; <code>exit<\/code> \u00e9 quando come\u00e7a a desaparecer; e <code>cover<\/code> abrange do primeiro ao \u00faltimo pixel vis\u00edvel. A documenta\u00e7\u00e3o do MDN explica que <code>animation-range-start<\/code> e <code>animation-range-end<\/code> aceitam um range nomeado, um valor de porcentagem, ou ambos combinados.<\/p>\n<p>Por exemplo, <code>animation-range-start: contain 25%<\/code> significa que a anima\u00e7\u00e3o come\u00e7a quando o elemento j\u00e1 est\u00e1 contido no viewport e 25% desse per\u00edodo de conten\u00e7\u00e3o j\u00e1 passou.<\/p>\n<h3>Onde entra sibling-index()<\/h3>\n<p>Escalonar anima\u00e7\u00f5es significa fazer cada item de uma lista come\u00e7ar um pouco depois do anterior. Em anima\u00e7\u00f5es baseadas em tempo, isso \u00e9 feito com <code>animation-delay<\/code> multiplicado pela posi\u00e7\u00e3o do item. Em anima\u00e7\u00f5es driven por scroll, \u00e9 necess\u00e1rio calcular o equivalente em porcentagem de scroll e saber a posi\u00e7\u00e3o de cada irm\u00e3o.<\/p>\n<p>A fun\u00e7\u00e3o <code>sibling-index()<\/code> \u00e9 \u00fatil aqui, pois retorna a posi\u00e7\u00e3o do elemento atual entre seus irm\u00e3os, come\u00e7ando em 1 para o primeiro filho. Isso permite calcular o escalonamento dentro de um <code>calc()<\/code> no CSS.<\/p>\n<p>A solu\u00e7\u00e3o de Meyer \u00e9:<\/p>\n<pre><code>animation-range-start: contain calc(10% + 2.5% * sibling-index());<\/code><\/pre>\n<p>Com isso, cada elemento come\u00e7a sua anima\u00e7\u00e3o em um ponto escalonado do scroll, sem necessidade de f\u00f3rmulas complexas ou reinven\u00e7\u00e3o de timelines.<\/p>\n<h2>O que isso significa na pr\u00e1tica<\/h2>\n<p>Para ver isso em a\u00e7\u00e3o, crie um HTML com oito spans dentro de um container:<\/p>\n<pre><code>&lt;p class=\"frase\"&gt;\n &lt;span&gt;E&lt;\/span&gt;&lt;span&gt;x&lt;\/span&gt;&lt;span&gt;e&lt;\/span&gt;&lt;span&gt;m&lt;\/span&gt;&lt;span&gt;p&lt;\/span&gt;&lt;span&gt;l&lt;\/span&gt;&lt;span&gt;o&lt;\/span&gt;&lt;span&gt;!&lt;\/span&gt;\n&lt;\/p&gt;<\/code><\/pre>\n<p>E o CSS correspondente:<\/p>\n<pre><code>@keyframes aparece {\n from { opacity: 0; transform: translateY(0.4em); }\n to { opacity: 1; transform: translateY(0); }\n}\n\n.frase span {\n display: inline-block;\n opacity: 0;\n animation: aparece linear both;\n animation-timeline: view();\n animation-range-start: contain calc(10% + 2.5% * sibling-index());\n animation-range-end: contain calc(30% + 2.5% * sibling-index());\n}<\/code><\/pre>\n<p>Note que <code>animation-range-start<\/code> deve ser declarado ap\u00f3s qualquer shorthand <code>animation<\/code> para evitar resets indesejados.<\/p>\n<h3>Easing continua funcionando<\/h3>\n<p>Uma vantagem dessa abordagem \u00e9 que ela preserva o uso de <code>animation-timing-function<\/code>, permitindo que cada elemento mantenha seu pr\u00f3prio easing, ao contr\u00e1rio de uma abordagem que unifica tudo em uma \u00fanica timeline.<\/p>\n<h2>Onde isso quebra<\/h2>\n<p>Existem algumas limita\u00e7\u00f5es:<\/p>\n<ul>\n<li><strong>Suporte de navegador:<\/strong> <code>sibling-index()<\/code> ainda \u00e9 recente, com suporte limitado a navegadores modernos. \u00c9 necess\u00e1rio usar <code>@supports<\/code> e fornecer fallbacks para navegadores sem suporte.<\/li>\n<li><strong>Elementos escondidos:<\/strong> <code>sibling-index()<\/code> conta elementos escondidos, podendo afetar o escalonamento.<\/li>\n<li><strong>Shadow DOM:<\/strong> Problemas podem ocorrer ao usar <code>sibling-index()<\/code> com componentes em Shadow DOM.<\/li>\n<\/ul>\n<h2>O que n\u00e3o d\u00e1 para afirmar ainda<\/h2>\n<p>A abordagem de Meyer \u00e9 eficaz para anima\u00e7\u00f5es driven por scroll, mas n\u00e3o substitui a f\u00f3rmula gen\u00e9rica em casos onde o input de progresso n\u00e3o \u00e9 scroll ou tempo. Al\u00e9m disso, a especifica\u00e7\u00e3o ainda \u00e9 um Editor&#8217;s Draft, o que significa que a implementa\u00e7\u00e3o pode variar entre navegadores.<\/p>\n<h2>Como testar isso voc\u00ea mesmo<\/h2>\n<p>Para testar, use um navegador compat\u00edvel como Chrome 138+ ou Safari 26.2+. Crie um HTML com uma lista de itens e aplique o CSS mostrado. Role a p\u00e1gina para observar o escalonamento. Experimente alterar o valor de <code>2.5%<\/code> e veja como isso afeta o timing das anima\u00e7\u00f5es.<\/p>\n<p>Considere usar a extens\u00e3o de debug do Bramus para visualizar e ajustar <code>animation-range-start<\/code> e <code>animation-range-end<\/code> em tempo real. Sempre forne\u00e7a um fallback est\u00e1tico ou baseado em tempo para navegadores sem suporte.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Como usar animation-range-start com sibling-index() para escalonar anima\u00e7\u00f5es baseadas em scroll em CSS, sem reinventar scroll timelines ou criar fun\u00e7\u00f5es de easing.<\/p>\n","protected":false},"author":2,"featured_media":842,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-843","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts\/843","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/comments?post=843"}],"version-history":[{"count":0,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts\/843\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media\/842"}],"wp:attachment":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media?parent=843"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/categories?post=843"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/tags?post=843"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}