Na edição 19 da newsletter What’s !important, publicada em 27 de outubro de 2026 no CSS-Tricks por Daniel Schwarz, um dos itens em destaque é o walkthrough de Dan Holloran sobre as scroll-state() queries. O roundup lista quatro valores que essa família de container queries aceita: scrollable, scrolled, snapped e stuck. É um recurso pequeno em superfície e grande em consequência: ele move para o CSS uma classe inteira de problemas que até ontem era feita com listener de scroll, IntersectionObserver ou requestAnimationFrame.
Este artigo não é o resumo do roundup. É o mergulho em uma só das novidades, porque é a que mais muda como você escreve interface.
O que é uma scroll-state query, por baixo
scroll-state() é uma nova família de container queries definida na spec CSS Conditional Rules Module Level 5. Ela deixa você estilizar descendentes de um container com base no estado de scroll desse container. O navegador já rastreia tudo isso internamente: se algo está preso via position: sticky, se está snapped num ancestral com scroll-snap, se ainda há overflow restante, em qual direção o usuário acabou de scrollar. scroll-state() apenas expõe esses fatos como condições consultáveis.
Essa última frase é a chave. O navegador já sabia. Ele precisa saber, porque é ele que posiciona o sticky, decide se o snap engatou, mede se existe conteúdo além da viewport do scroller. O que faltava era um canal declarativo para você perguntar. Antes, para descobrir que seu header estava grudado no topo, você precisava criar uma sentinela invisível um pixel acima dele e observar com IntersectionObserver. Funcionava, mas era um proxy: você inferia o estado a partir de outra coisa.
Pense no termostato de uma geladeira. O compressor sabe se o compartimento está frio porque ele mesmo liga e desliga. Antes das scroll-state queries, para desenhar uma luzinha que acendesse junto com o compressor, você precisava colar um sensor de temperatura por fora da porta e inferir. Agora o compressor expõe o próprio estado. A analogia quebra num ponto importante: o navegador não emite eventos de mudança de estado para você consumir em JS, ele apenas aplica regras CSS condicionais. É um canal declarativo, não um observable.
Como o container é declarado
Dois passos. Primeiro, você diz ao navegador que o comportamento de scroll de um elemento deve ser observável. Seja ele stuck, snapped ou scrollable, esse estado precisa ser rastreado. Você habilita isso definindo a propriedade container-type para o novo valor scroll-state.
.header-wrap {
container-type: scroll-state;
position: sticky;
top: 0;
}
Segundo, uma regra que vale para toda a família de container queries e que trava quase todo mundo na primeira tentativa: um elemento não pode se estilizar com base no próprio scroll-state. A regra @container precisa mirar um descendente (um filho ou pseudo-elemento) do container.
Isso tem razão de ser. O estado stuck depende de layout. Se a mesma declaração que mudasse o estado também mudasse o layout do próprio sticky (por exemplo, aumentando a altura ao grudar), o navegador entraria em ciclo: estilou, re-layoutou, deixou de estar stuck, estilou de novo. Forçar o estilo para um filho corta esse loop porque o filho não participa do cálculo de posicionamento do pai sticky.
Os quatro descritores
O Chrome 133 enviou três valores de scroll-state: stuck, snapped e scrollable. Stuck detecta se um elemento position: sticky está preso a uma borda, snapped detecta qual item em um container de scroll-snap está atualmente snapped, e scrollable verifica se há conteúdo não scrollado além de uma borda, útil para mostrar ou esconder setas de scroll. O Chrome 144 adiciona o estado scrolled, que rastreia a direção do scroll mais recente, viabilizando headers que escondem ao descer e indicadores de rolagem sem JS.
Os valores aceitos dentro de cada descritor seguem a geometria do scroll:
stuck:top,bottom,left,right,inset-block-start,inset-inline-end, ounone.snapped:x,y,block,inlineounone.scrollable: a direção onde ainda há conteúdo a ser alcançado (top,bottom,left,right).scrolled: a direção do último movimento.
Vale notar o que isso não é. scroll-state só detecta estados binários (stuck ou não stuck, snapped ou não snapped, scrollable ou não scrollable). Não existe aqui um “está 37% scrollado”. Para isso você usa scroll-driven animations, que é outro recurso.
O que isso significa na prática
Três padrões que caíam direto no backlog de JavaScript agora cabem em CSS.
Header sticky que ganha sombra ao grudar
.header-wrap {
container-type: scroll-state;
position: sticky;
top: 0;
}
.header-wrap .header {
transition: box-shadow 0.2s ease;
}
@container scroll-state(stuck: top) {
.header {
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);
}
}
Note dois detalhes. A sombra está no filho .header, não no .header-wrap que é o container. E uma query stuck só casa num container que seja de fato position: sticky com um inset para aquele lado. Sem o inset não há stuck state a reportar. Esquecer o top: 0 é a causa mais comum de “não funciona e não dá erro”.
Carrossel que destaca o item centralizado
.carousel {
overflow-x: auto;
scroll-snap-type: x mandatory;
display: flex;
}
.carousel > article {
container-type: scroll-state;
scroll-snap-align: center;
flex: 0 0 80%;
}
.carousel > article > * {
transition: opacity 0.3s ease;
}
@container not scroll-state(snapped: x) {
.carousel > article > * {
opacity: 0.3;
}
}
O not inverte a condição: quando o article não está snapped no eixo x, seus filhos ficam esmaecidos. Isso resolve, sem listener de scroll, o problema clássico de “qual card é o ativo”.
Indicador de “ainda tem mais” num scroller
.pane {
container-type: scroll-state;
overflow-y: auto;
max-height: 400px;
}
.pane::after {
content: "";
position: sticky;
bottom: 0;
display: block;
height: 32px;
background: linear-gradient(to top, white, transparent);
opacity: 0;
transition: opacity 0.3s ease;
}
@container scroll-state(scrollable: bottom) {
.pane::after {
opacity: 1;
}
}
Esse padrão específico, o gradiente que desaparece quando o usuário chega no fim, é o tipo de affordance que a gente costumava deixar quebrada porque o custo de implementar com JS não compensava para um detalhe visual. Agora o custo é zero.
Nos design systems que publiquei para equipes de IA, o número de componentes de scroll que precisavam de um JS auxiliar só para “está no topo?” ou “ainda tem mais pra baixo?” era desproporcional à importância do detalhe. Mover isso para CSS tira um ponto inteiro de contrato entre o componente visual e qualquer código imperativo em volta, o que para quem consome o design system é um alívio real.
Onde quebra
O ponto mais honesto deste artigo é este: como de abril de 2026, scroll-state() é entregue e sem flag em todos os navegadores Chromium, mas ainda não é um recurso Baseline, Firefox e Safari estão correndo atrás. Chrome versões 151 a 153 suportam. Safari 3.1 até 26.3 não suporta. Safari 26.4 não suporta. Safari 26.5 até 27 não suporta. Safari TP com suporte desconhecido. Firefox também segue sem suporte nas versões recentes.
Isso tem duas consequências práticas. A primeira: trate scroll-state como enhancement, não como mecanismo. O carrossel precisa funcionar com os itens não dimmed, o header precisa funcionar sem a sombra, o gradiente simplesmente não aparece. Uma sombra que nunca aparece, um vizinho esmaecido que fica brilhante, um gradiente que fica escondido: nada quebra, o carrossel ainda rola, o header ainda gruda. Esse é o teste de design punitivo: a interface sem o aprimoramento tem que continuar coerente.
A segunda: feature detection é obrigatória se você for montar fallback com JS. Use @supports (container-type: scroll-state) para gatear o CSS, e no JS use CSS.supports('container-type', 'scroll-state') para não rodar o IntersectionObserver em quem já tem o recurso nativo.
if (!CSS.supports('container-type', 'scroll-state')) {
// mantém o IntersectionObserver antigo só para Firefox e Safari
initStickyObserver();
}
Houve um projeto meu de dashboard financeiro em que a sombra do header sticky era controlada por uma classe .is-stuck aplicada via IntersectionObserver. Em telas com muitos widgets, o observer disparava enough para causar jank perceptível na rolagem. A alternativa era mover para CSS puro, o que na época (sem scroll-state) significava gambiarra. Hoje, para o subconjunto de usuários em Chromium, essa classe inteira some do bundle. O custo é que a lógica agora vive em dois lugares, CSS para quem suporta e JS para quem não, até Firefox e Safari alcançarem.
Outras armadilhas específicas:
- Não confunda com container queries de tamanho. container-type: scroll-state é separado de container-type: inline-size; você pode combinar: container-type: inline-size scroll-state. Se você precisa dos dois, declare os dois.
- O container precisa ser o próprio sticky/snap/scroller. Não adianta colocar
container-type: scroll-statenum ancestral do sticky. O container tem que ser o elemento cujo estado você quer observar. - Snapped exige scroll-snap configurado de verdade. Sem
scroll-snap-typeno pai escroll-snap-alignno filho, o estado nunca é verdadeiro.
O que não dá para afirmar ainda
Três pontos onde eu não arrisco firmeza. Um: não encontrei documentação detalhada do timing exato das transições de estado, ou seja, se stuck: top vira verdadeiro no instante em que o sticky encosta no inset ou alguns pixels depois. Para a maioria dos usos (sombra, cor de fundo) isso não importa, mas para animações precisas pode importar.
Dois: o scrolled, por ser o descritor mais recente, tem menos relatos de uso em produção. A documentação é clara sobre o que ele faz, mas não vi ainda uma análise de como ele se comporta com rolagens muito curtas, com overscroll, ou com trackpads que invertem a direção.
Três: o roadmap de Firefox e Safari. O bug bugzil.la/1931980 está aberto no Firefox, mas estimativa de ship é tudo menos confiável. Quem precisa de paridade cross-browser deve planejar manter o fallback de JS pelo próximo ano, no mínimo.
Como testar isso você mesmo
Um caminho de dez minutos. Crie um HTML com três seções altas e um header fixo:
<!DOCTYPE html>
<style>
body { margin: 0; font-family: system-ui; }
.header-wrap {
container-type: scroll-state;
position: sticky;
top: 0;
background: white;
}
.header {
padding: 1rem;
transition: box-shadow 0.2s, background 0.2s;
}
section { height: 100vh; padding: 2rem; }
section:nth-child(odd) { background: #f5f5f5; }
@container scroll-state(stuck: top) {
.header {
box-shadow: 0 2px 10px rgba(0,0,0,0.15);
background: #fffbe6;
}
}
</style>
<div class="header-wrap">
<header class="header">Header que muda ao grudar</header>
</div>
<section>Role para baixo</section>
<section>Continue rolando</section>
<section>Role de volta ao topo</section>
Abra em Chrome 133 ou superior. No topo, o header é branco e sem sombra. Role um pixel: fundo amarelo claro e sombra. Role de volta: volta ao estado inicial. Nenhum listener, nenhum observer.
Depois, abra o mesmo arquivo em Firefox ou Safari. Observe que o header continua funcionando como sticky, só não ganha o destaque visual. Esse é o teste real: se a sua interface sobrevive esse segundo cenário sem parecer quebrada, o enhancement pode ir pra produção amanhã.





