{"id":817,"date":"2026-11-02T18:32:57","date_gmt":"2026-11-02T21:32:57","guid":{"rendered":"https:\/\/yellowkode.com\/blog\/scrollspy-sem-javascript-scroll-target-group-target-current\/"},"modified":"2026-11-02T18:32:57","modified_gmt":"2026-11-02T21:32:57","slug":"scrollspy-sem-javascript-scroll-target-group-target-current","status":"publish","type":"post","link":"https:\/\/yellowkode.com\/blog\/scrollspy-sem-javascript-scroll-target-group-target-current\/","title":{"rendered":"Scrollspy sem JavaScript: como scroll-target-group e :target-current movem o estado para o navegador"},"content":{"rendered":"<h2>Introdu\u00e7\u00e3o ao Scrollspy sem JavaScript<\/h2>\n<p>Em 14 de outubro de 2026, Mojtaba Seyedi publicou no blog da Master.dev um tutorial mostrando como construir um scrollspy inteiro em CSS, sem IntersectionObserver, sem listener de scroll, sem contador de posi\u00e7\u00e3o em JavaScript. O mecanismo central do tutorial s\u00e3o duas coisas: a propriedade <code>scroll-target-group<\/code> e a pseudoclasse <code>:target-current<\/code>, ambas definidas no CSS Overflow Module Level 5.<\/p>\n<h2>O que \u00e9 um Scrollspy e por que ele costuma ser fr\u00e1gil<\/h2>\n<p>Scrollspy \u00e9 o padr\u00e3o de navega\u00e7\u00e3o em que a lista de links no topo (ou lateral) de uma p\u00e1gina destaca o item correspondente \u00e0 se\u00e7\u00e3o que est\u00e1 vis\u00edvel no momento. Documenta\u00e7\u00e3o longa, p\u00e1gina de produto com \u00e2ncoras, sum\u00e1rio de artigo: todos usam isso. At\u00e9 agora, para fazer isso funcionar, a interface precisava manter em JavaScript um estado paralelo ao do navegador: qual se\u00e7\u00e3o est\u00e1 vis\u00edvel, qual link corresponde a ela, quando trocar a classe <code>active<\/code>. O browser j\u00e1 sabia a posi\u00e7\u00e3o do scroll, mas essa informa\u00e7\u00e3o n\u00e3o era observ\u00e1vel por CSS de forma estruturada, ent\u00e3o a aplica\u00e7\u00e3o a recalculava.<\/p>\n<h2>Como scroll-target-group e :target-current movem o estado para o navegador<\/h2>\n<p>A nova API inverte isso. Em vez de a aplica\u00e7\u00e3o observar o scroll e deduzir o estado, voc\u00ea declara uma rela\u00e7\u00e3o e deixa o navegador manter o estado. Definir <code>scroll-target-group: auto<\/code> em um elemento o marca como um container de grupo de marcadores de rolagem. Na pr\u00e1tica, voc\u00ea aponta para o <code>&lt;nav&gt;<\/code> ou a <code>&lt;ol&gt;<\/code> que cont\u00e9m os links de \u00e2ncora, e diz: este conjunto de <code>&lt;a&gt;<\/code> aqui dentro representa marcadores que correspondem \u00e0s se\u00e7\u00f5es apontadas por seus <code>href<\/code>. O browser ent\u00e3o roda um algoritmo para calcular qual elemento \u00e9 o <code>:target-current<\/code> em cada momento, isto \u00e9, qual link tem o alvo atualmente em vista.<\/p>\n<h2>O que isso significa na pr\u00e1tica<\/h2>\n<p>Um scrollspy m\u00ednimo com essa abordagem fica assim. Primeiro, o HTML sem nada de especial:<\/p>\n<pre><code>&lt;nav class=\"toc\"&gt;\n &lt;ol&gt;\n &lt;li&gt;&lt;a href=\"#intro\"&gt;Introdu\u00e7\u00e3o&lt;\/a&gt;&lt;\/li&gt;\n &lt;li&gt;&lt;a href=\"#mecanismo\"&gt;Mecanismo&lt;\/a&gt;&lt;\/li&gt;\n &lt;li&gt;&lt;a href=\"#limites\"&gt;Limites&lt;\/a&gt;&lt;\/li&gt;\n &lt;\/ol&gt;\n&lt;\/nav&gt;\n\n&lt;section id=\"intro\"&gt;...&lt;\/section&gt;\n&lt;section id=\"mecanismo\"&gt;...&lt;\/section&gt;\n&lt;section id=\"limites\"&gt;...&lt;\/section&gt;<\/code><\/pre>\n<p>E o CSS inteiro que faz o destaque funcionar:<\/p>\n<pre><code>.toc ol {\n scroll-target-group: auto;\n}\n\n.toc a:target-current {\n color: #c53030;\n font-weight: 600;\n}<\/code><\/pre>\n<p>Duas regras. Nenhum <code>IntersectionObserver<\/code>, nenhum <code>addEventListener('scroll', ...)<\/code>, nenhum <code>requestAnimationFrame<\/code>, nenhum debounce.<\/p>\n<h2>Onde isso quebra<\/h2>\n<p>Agora o que a documenta\u00e7\u00e3o n\u00e3o vende, mas \u00e9 o que decide se d\u00e1 para usar. Primeiro, suporte. A pseudoclasse <code>:target-current<\/code> tem disponibilidade limitada, n\u00e3o \u00e9 Baseline porque n\u00e3o funciona em alguns dos browsers mais usados, e a MDN marca como tecnologia experimental. Em 2026 isso significa Chrome e Safari recentes com suporte parcial, e Firefox ainda caminhando. Scrollspy puramente em CSS, hoje, \u00e9 progressive enhancement: a p\u00e1gina precisa continuar naveg\u00e1vel sem o destaque, e voc\u00ea s\u00f3 adiciona a propriedade dentro de um <code>@supports (selector(:target-current))<\/code> ou aceita que a classe <code>active<\/code> em JavaScript continue como fallback.<\/p>\n<p>Segundo, uma pegadinha de implementa\u00e7\u00e3o que Sara Soueidan documentou. Mesmo que a especifica\u00e7\u00e3o diga que a feature associa marcadores de rolagem a elementos em um scroller, a implementa\u00e7\u00e3o atual da pseudoclasse <code>:target-current<\/code> parece funcionar apenas para <code>::scroll-markers<\/code> gerados por CSS, n\u00e3o para os nativos em HTML.<\/p>\n<p>Terceiro, acessibilidade. Destacar visualmente o link ativo n\u00e3o substitui marcar semanticamente qual \u00e9 o item corrente. <code>aria-current<\/code> aceita um de sete valores. Enquanto <code>:target-current<\/code> for apenas visual, leitor de tela continua sem saber qual se\u00e7\u00e3o est\u00e1 ativa, a n\u00e3o ser que voc\u00ea tamb\u00e9m reflita isso em <code>aria-current=\"location\"<\/code>. Isso ainda precisa de JavaScript, ou de uma API complementar que ainda n\u00e3o existe.<\/p>\n<p>Quarto, o algoritmo de &#8220;qual est\u00e1 em vista&#8221; \u00e9 do browser e n\u00e3o \u00e9 totalmente parametriz\u00e1vel. Se o seu header fixo cobre 80 pixels do topo, pode ser que o browser considere ativa a se\u00e7\u00e3o que ainda est\u00e1 escondida atr\u00e1s dele. Para esse caso, <code>scroll-padding-top<\/code> no container de scroll ajuda, mas \u00e9 mais um bot\u00e3o para calibrar e testar.<\/p>\n<h2>O que n\u00e3o d\u00e1 para afirmar ainda<\/h2>\n<p>O artigo original \u00e9 um tutorial, n\u00e3o um benchmark. N\u00e3o encontrei medida p\u00fablica comparando o custo de main thread entre scrollspy com IntersectionObserver e scrollspy com <code>scroll-target-group<\/code>, ent\u00e3o a afirma\u00e7\u00e3o intuitiva de que &#8220;\u00e9 mais perform\u00e1tico&#8221; eu n\u00e3o vou fazer. \u00c9 plaus\u00edvel, porque as anima\u00e7\u00f5es baseadas em scroll do CSS s\u00e3o perform\u00e1ticas, enquanto anima\u00e7\u00f5es baseadas em scroll em JavaScript exigem listeners de scroll e objetos IntersectionObserver na main thread para rastrear elementos pela scrollport, mas scrollspy n\u00e3o \u00e9 exatamente a mesma coisa que anima\u00e7\u00e3o baseada em scroll, e eu n\u00e3o testei.<\/p>\n<p>Tamb\u00e9m n\u00e3o d\u00e1 para prever quando Firefox entrega implementa\u00e7\u00e3o est\u00e1vel nem se o comportamento de <code>:target-current<\/code> para \u00e2ncoras <code>&lt;a&gt;<\/code> nativas vai ficar consistente entre engines. A especifica\u00e7\u00e3o \u00e9 CSS Overflow Module Level 5, que ainda est\u00e1 em evolu\u00e7\u00e3o.<\/p>\n<h2>Como testar isso voc\u00ea mesmo<\/h2>\n<p>Um caminho pequeno, 15 minutos:<\/p>\n<ol>\n<li>Abra um arquivo HTML em branco. Coloque um <code>&lt;nav&gt;<\/code> com tr\u00eas ou quatro <code>&lt;a href=\"#algo\"&gt;<\/code> no topo.<\/li>\n<li>Logo abaixo, coloque tr\u00eas ou quatro <code>&lt;section id=\"algo\"&gt;<\/code> com altura suficiente para rolar (<code>min-height: 100vh<\/code> em cada uma resolve).<\/li>\n<li>Aplique <code>scroll-target-group: auto<\/code> no <code>&lt;ol&gt;<\/code> ou <code>&lt;ul&gt;<\/code> dentro do <code>&lt;nav&gt;<\/code>.<\/li>\n<li>Estilize <code>a:target-current<\/code> com uma cor diferente.<\/li>\n<li>Abra no Chrome 139+ ou Safari 26+ e role. Depois abra no Firefox e compare: o destaque n\u00e3o aparece, e \u00e9 exatamente a\u00ed que voc\u00ea decide qual \u00e9 o seu fallback.<\/li>\n<\/ol>\n<p>Envolva a regra em <code>@supports (selector(:target-current)) { ... }<\/code> se for colocar em produ\u00e7\u00e3o, e mantenha uma classe <code>.is-active<\/code> aplicada por JavaScript como caminho padr\u00e3o at\u00e9 o suporte estabilizar. \u00c9 o tipo de decis\u00e3o em que a interface declara onde ela para: enquanto o navegador souber manter o estado, estilize em cima dele; quando n\u00e3o souber, assuma a conta de volta.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Entenda como scroll-target-group e :target-current substituem o IntersectionObserver em scrollspies e o que muda no estado da sua interface.<\/p>\n","protected":false},"author":2,"featured_media":816,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-817","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\/817","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=817"}],"version-history":[{"count":0,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts\/817\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media\/816"}],"wp:attachment":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media?parent=817"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/categories?post=817"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/tags?post=817"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}