Introdução ao Scrollspy sem JavaScript
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ção em JavaScript. O mecanismo central do tutorial são duas coisas: a propriedade scroll-target-group e a pseudoclasse :target-current, ambas definidas no CSS Overflow Module Level 5.
O que é um Scrollspy e por que ele costuma ser frágil
Scrollspy é o padrão de navegação em que a lista de links no topo (ou lateral) de uma página destaca o item correspondente à seção que está visível no momento. Documentação longa, página de produto com âncoras, sumário de artigo: todos usam isso. Até agora, para fazer isso funcionar, a interface precisava manter em JavaScript um estado paralelo ao do navegador: qual seção está visível, qual link corresponde a ela, quando trocar a classe active. O browser já sabia a posição do scroll, mas essa informação não era observável por CSS de forma estruturada, então a aplicação a recalculava.
Como scroll-target-group e :target-current movem o estado para o navegador
A nova API inverte isso. Em vez de a aplicação observar o scroll e deduzir o estado, você declara uma relação e deixa o navegador manter o estado. Definir scroll-target-group: auto em um elemento o marca como um container de grupo de marcadores de rolagem. Na prática, você aponta para o <nav> ou a <ol> que contém os links de âncora, e diz: este conjunto de <a> aqui dentro representa marcadores que correspondem às seções apontadas por seus href. O browser então roda um algoritmo para calcular qual elemento é o :target-current em cada momento, isto é, qual link tem o alvo atualmente em vista.
O que isso significa na prática
Um scrollspy mínimo com essa abordagem fica assim. Primeiro, o HTML sem nada de especial:
<nav class="toc">
<ol>
<li><a href="#intro">Introdução</a></li>
<li><a href="#mecanismo">Mecanismo</a></li>
<li><a href="#limites">Limites</a></li>
</ol>
</nav>
<section id="intro">...</section>
<section id="mecanismo">...</section>
<section id="limites">...</section>
E o CSS inteiro que faz o destaque funcionar:
.toc ol {
scroll-target-group: auto;
}
.toc a:target-current {
color: #c53030;
font-weight: 600;
}
Duas regras. Nenhum IntersectionObserver, nenhum addEventListener('scroll', ...), nenhum requestAnimationFrame, nenhum debounce.
Onde isso quebra
Agora o que a documentação não vende, mas é o que decide se dá para usar. Primeiro, suporte. A pseudoclasse :target-current tem disponibilidade limitada, não é Baseline porque não 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, é progressive enhancement: a página precisa continuar navegável sem o destaque, e você só adiciona a propriedade dentro de um @supports (selector(:target-current)) ou aceita que a classe active em JavaScript continue como fallback.
Segundo, uma pegadinha de implementação que Sara Soueidan documentou. Mesmo que a especificação diga que a feature associa marcadores de rolagem a elementos em um scroller, a implementação atual da pseudoclasse :target-current parece funcionar apenas para ::scroll-markers gerados por CSS, não para os nativos em HTML.
Terceiro, acessibilidade. Destacar visualmente o link ativo não substitui marcar semanticamente qual é o item corrente. aria-current aceita um de sete valores. Enquanto :target-current for apenas visual, leitor de tela continua sem saber qual seção está ativa, a não ser que você também reflita isso em aria-current="location". Isso ainda precisa de JavaScript, ou de uma API complementar que ainda não existe.
Quarto, o algoritmo de “qual está em vista” é do browser e não é totalmente parametrizável. Se o seu header fixo cobre 80 pixels do topo, pode ser que o browser considere ativa a seção que ainda está escondida atrás dele. Para esse caso, scroll-padding-top no container de scroll ajuda, mas é mais um botão para calibrar e testar.
O que não dá para afirmar ainda
O artigo original é um tutorial, não um benchmark. Não encontrei medida pública comparando o custo de main thread entre scrollspy com IntersectionObserver e scrollspy com scroll-target-group, então a afirmação intuitiva de que “é mais performático” eu não vou fazer. É plausível, porque as animações baseadas em scroll do CSS são performáticas, enquanto animações baseadas em scroll em JavaScript exigem listeners de scroll e objetos IntersectionObserver na main thread para rastrear elementos pela scrollport, mas scrollspy não é exatamente a mesma coisa que animação baseada em scroll, e eu não testei.
Também não dá para prever quando Firefox entrega implementação estável nem se o comportamento de :target-current para âncoras <a> nativas vai ficar consistente entre engines. A especificação é CSS Overflow Module Level 5, que ainda está em evolução.
Como testar isso você mesmo
Um caminho pequeno, 15 minutos:
- Abra um arquivo HTML em branco. Coloque um
<nav>com três ou quatro<a href="#algo">no topo. - Logo abaixo, coloque três ou quatro
<section id="algo">com altura suficiente para rolar (min-height: 100vhem cada uma resolve). - Aplique
scroll-target-group: autono<ol>ou<ul>dentro do<nav>. - Estilize
a:target-currentcom uma cor diferente. - Abra no Chrome 139+ ou Safari 26+ e role. Depois abra no Firefox e compare: o destaque não aparece, e é exatamente aí que você decide qual é o seu fallback.
Envolva a regra em @supports (selector(:target-current)) { ... } se for colocar em produção, e mantenha uma classe .is-active aplicada por JavaScript como caminho padrão até o suporte estabilizar. É o tipo de decisão em que a interface declara onde ela para: enquanto o navegador souber manter o estado, estilize em cima dele; quando não souber, assuma a conta de volta.





