{"id":805,"date":"2026-10-27T18:35:25","date_gmt":"2026-10-27T21:35:25","guid":{"rendered":"https:\/\/yellowkode.com\/blog\/scroll-state-css-detectando-stuck-snapped-scrollable-scrolled-sem-javascript\/"},"modified":"2026-10-27T18:35:25","modified_gmt":"2026-10-27T21:35:25","slug":"scroll-state-css-detectando-stuck-snapped-scrollable-scrolled-sem-javascript","status":"publish","type":"post","link":"https:\/\/yellowkode.com\/blog\/scroll-state-css-detectando-stuck-snapped-scrollable-scrolled-sem-javascript\/","title":{"rendered":"scroll-state() em CSS: detectando stuck, snapped, scrollable e scrolled sem JavaScript"},"content":{"rendered":"<p>Na edi\u00e7\u00e3o 19 da newsletter <em>What&#8217;s !important<\/em>, publicada em 27 de outubro de 2026 no CSS-Tricks por Daniel Schwarz, um dos itens em destaque \u00e9 o walkthrough de Dan Holloran sobre as <code>scroll-state()<\/code> queries. O roundup lista quatro valores que essa fam\u00edlia de container queries aceita: <code>scrollable<\/code>, <code>scrolled<\/code>, <code>snapped<\/code> e <code>stuck<\/code>. \u00c9 um recurso pequeno em superf\u00edcie e grande em consequ\u00eancia: ele move para o CSS uma classe inteira de problemas que at\u00e9 ontem era feita com listener de <code>scroll<\/code>, <code>IntersectionObserver<\/code> ou <code>requestAnimationFrame<\/code>.<\/p>\n<p>Este artigo n\u00e3o \u00e9 o resumo do roundup. \u00c9 o mergulho em uma s\u00f3 das novidades, porque \u00e9 a que mais muda como voc\u00ea escreve interface.<\/p>\n<h2>O que \u00e9 uma scroll-state query, por baixo<\/h2>\n<p>scroll-state() \u00e9 uma nova fam\u00edlia de container queries definida na spec CSS Conditional Rules Module Level 5. Ela deixa voc\u00ea estilizar descendentes de um container com base no estado de scroll desse container. O navegador j\u00e1 rastreia tudo isso internamente: se algo est\u00e1 preso via position: sticky, se est\u00e1 snapped num ancestral com scroll-snap, se ainda h\u00e1 overflow restante, em qual dire\u00e7\u00e3o o usu\u00e1rio acabou de scrollar. scroll-state() apenas exp\u00f5e esses fatos como condi\u00e7\u00f5es consult\u00e1veis.<\/p>\n<p>Essa \u00faltima frase \u00e9 a chave. O navegador <em>j\u00e1 sabia<\/em>. Ele precisa saber, porque \u00e9 ele que posiciona o sticky, decide se o snap engatou, mede se existe conte\u00fado al\u00e9m da viewport do scroller. O que faltava era um canal declarativo para voc\u00ea perguntar. Antes, para descobrir que seu header estava grudado no topo, voc\u00ea precisava criar uma sentinela invis\u00edvel um pixel acima dele e observar com <code>IntersectionObserver<\/code>. Funcionava, mas era um proxy: voc\u00ea inferia o estado a partir de outra coisa.<\/p>\n<p>Pense no termostato de uma geladeira. O compressor sabe se o compartimento est\u00e1 frio porque ele mesmo liga e desliga. Antes das scroll-state queries, para desenhar uma luzinha que acendesse junto com o compressor, voc\u00ea precisava colar um sensor de temperatura por fora da porta e inferir. Agora o compressor exp\u00f5e o pr\u00f3prio estado. A analogia quebra num ponto importante: o navegador n\u00e3o emite eventos de mudan\u00e7a de estado para voc\u00ea consumir em JS, ele apenas aplica regras CSS condicionais. \u00c9 um canal declarativo, n\u00e3o um observable.<\/p>\n<h3>Como o container \u00e9 declarado<\/h3>\n<p>Dois passos. Primeiro, voc\u00ea diz ao navegador que o comportamento de scroll de um elemento deve ser observ\u00e1vel. Seja ele stuck, snapped ou scrollable, esse estado precisa ser rastreado. Voc\u00ea habilita isso definindo a propriedade container-type para o novo valor scroll-state.<\/p>\n<pre><code>.header-wrap {\n container-type: scroll-state;\n position: sticky;\n top: 0;\n}<\/code><\/pre>\n<p>Segundo, uma regra que vale para toda a fam\u00edlia de container queries e que trava quase todo mundo na primeira tentativa: um elemento n\u00e3o pode se estilizar com base no pr\u00f3prio scroll-state. A regra @container precisa mirar um descendente (um filho ou pseudo-elemento) do container.<\/p>\n<p>Isso tem raz\u00e3o de ser. O estado <em>stuck<\/em> depende de layout. Se a mesma declara\u00e7\u00e3o que mudasse o estado tamb\u00e9m mudasse o layout do pr\u00f3prio sticky (por exemplo, aumentando a altura ao grudar), o navegador entraria em ciclo: estilou, re-layoutou, deixou de estar stuck, estilou de novo. For\u00e7ar o estilo para um filho corta esse loop porque o filho n\u00e3o participa do c\u00e1lculo de posicionamento do pai sticky.<\/p>\n<h3>Os quatro descritores<\/h3>\n<p>O Chrome 133 enviou tr\u00eas valores de scroll-state: stuck, snapped e scrollable. Stuck detecta se um elemento position: sticky est\u00e1 preso a uma borda, snapped detecta qual item em um container de scroll-snap est\u00e1 atualmente snapped, e scrollable verifica se h\u00e1 conte\u00fado n\u00e3o scrollado al\u00e9m de uma borda, \u00fatil para mostrar ou esconder setas de scroll. O Chrome 144 adiciona o estado scrolled, que rastreia a dire\u00e7\u00e3o do scroll mais recente, viabilizando headers que escondem ao descer e indicadores de rolagem sem JS.<\/p>\n<p>Os valores aceitos dentro de cada descritor seguem a geometria do scroll:<\/p>\n<ul>\n<li><code>stuck<\/code>: <code>top<\/code>, <code>bottom<\/code>, <code>left<\/code>, <code>right<\/code>, <code>inset-block-start<\/code>, <code>inset-inline-end<\/code>, ou <code>none<\/code>.<\/li>\n<li><code>snapped<\/code>: <code>x<\/code>, <code>y<\/code>, <code>block<\/code>, <code>inline<\/code> ou <code>none<\/code>.<\/li>\n<li><code>scrollable<\/code>: a dire\u00e7\u00e3o onde ainda h\u00e1 conte\u00fado a ser alcan\u00e7ado (<code>top<\/code>, <code>bottom<\/code>, <code>left<\/code>, <code>right<\/code>).<\/li>\n<li><code>scrolled<\/code>: a dire\u00e7\u00e3o do \u00faltimo movimento.<\/li>\n<\/ul>\n<p>Vale notar o que isso <em>n\u00e3o<\/em> \u00e9. scroll-state s\u00f3 detecta estados bin\u00e1rios (stuck ou n\u00e3o stuck, snapped ou n\u00e3o snapped, scrollable ou n\u00e3o scrollable). N\u00e3o existe aqui um &#8220;est\u00e1 37% scrollado&#8221;. Para isso voc\u00ea usa scroll-driven animations, que \u00e9 outro recurso.<\/p>\n<h2>O que isso significa na pr\u00e1tica<\/h2>\n<p>Tr\u00eas padr\u00f5es que ca\u00edam direto no backlog de JavaScript agora cabem em CSS.<\/p>\n<h3>Header sticky que ganha sombra ao grudar<\/h3>\n<pre><code>.header-wrap {\n container-type: scroll-state;\n position: sticky;\n top: 0;\n}\n\n.header-wrap .header {\n transition: box-shadow 0.2s ease;\n}\n\n@container scroll-state(stuck: top) {\n .header {\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);\n }\n}<\/code><\/pre>\n<p>Note dois detalhes. A sombra est\u00e1 no filho <code>.header<\/code>, n\u00e3o no <code>.header-wrap<\/code> que \u00e9 o container. E uma query stuck s\u00f3 casa num container que seja de fato position: sticky com um inset para aquele lado. Sem o inset n\u00e3o h\u00e1 stuck state a reportar. Esquecer o <code>top: 0<\/code> \u00e9 a causa mais comum de &#8220;n\u00e3o funciona e n\u00e3o d\u00e1 erro&#8221;.<\/p>\n<h3>Carrossel que destaca o item centralizado<\/h3>\n<pre><code>.carousel {\n overflow-x: auto;\n scroll-snap-type: x mandatory;\n display: flex;\n}\n\n.carousel > article {\n container-type: scroll-state;\n scroll-snap-align: center;\n flex: 0 0 80%;\n}\n\n.carousel > article > * {\n transition: opacity 0.3s ease;\n}\n\n@container not scroll-state(snapped: x) {\n .carousel > article > * {\n opacity: 0.3;\n }\n}<\/code><\/pre>\n<p>O <code>not<\/code> inverte a condi\u00e7\u00e3o: quando o article <em>n\u00e3o<\/em> est\u00e1 snapped no eixo x, seus filhos ficam esmaecidos. Isso resolve, sem listener de scroll, o problema cl\u00e1ssico de &#8220;qual card \u00e9 o ativo&#8221;.<\/p>\n<h3>Indicador de &#8220;ainda tem mais&#8221; num scroller<\/h3>\n<pre><code>.pane {\n container-type: scroll-state;\n overflow-y: auto;\n max-height: 400px;\n}\n\n.pane::after {\n content: \"\";\n position: sticky;\n bottom: 0;\n display: block;\n height: 32px;\n background: linear-gradient(to top, white, transparent);\n opacity: 0;\n transition: opacity 0.3s ease;\n}\n\n@container scroll-state(scrollable: bottom) {\n .pane::after {\n opacity: 1;\n }\n}<\/code><\/pre>\n<p>Esse padr\u00e3o espec\u00edfico, o gradiente que desaparece quando o usu\u00e1rio chega no fim, \u00e9 o tipo de affordance que a gente costumava deixar quebrada porque o custo de implementar com JS n\u00e3o compensava para um detalhe visual. Agora o custo \u00e9 zero.<\/p>\n<p>Nos design systems que publiquei para equipes de IA, o n\u00famero de componentes de scroll que precisavam de um JS auxiliar s\u00f3 para &#8220;est\u00e1 no topo?&#8221; ou &#8220;ainda tem mais pra baixo?&#8221; era desproporcional \u00e0 import\u00e2ncia do detalhe. Mover isso para CSS tira um ponto inteiro de contrato entre o componente visual e qualquer c\u00f3digo imperativo em volta, o que para quem consome o design system \u00e9 um al\u00edvio real.<\/p>\n<h2>Onde quebra<\/h2>\n<p>O ponto mais honesto deste artigo \u00e9 este: como de abril de 2026, scroll-state() \u00e9 entregue e sem flag em todos os navegadores Chromium, mas ainda n\u00e3o \u00e9 um recurso Baseline, Firefox e Safari est\u00e3o correndo atr\u00e1s. Chrome vers\u00f5es 151 a 153 suportam. Safari 3.1 at\u00e9 26.3 n\u00e3o suporta. Safari 26.4 n\u00e3o suporta. Safari 26.5 at\u00e9 27 n\u00e3o suporta. Safari TP com suporte desconhecido. Firefox tamb\u00e9m segue sem suporte nas vers\u00f5es recentes.<\/p>\n<p>Isso tem duas consequ\u00eancias pr\u00e1ticas. A primeira: trate scroll-state como enhancement, n\u00e3o como mecanismo. O carrossel precisa funcionar com os itens n\u00e3o dimmed, o header precisa funcionar sem a sombra, o gradiente simplesmente n\u00e3o 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 \u00e9 o teste de design punitivo: a interface sem o aprimoramento tem que continuar coerente.<\/p>\n<p>A segunda: feature detection \u00e9 obrigat\u00f3ria se voc\u00ea for montar fallback com JS. Use <code>@supports (container-type: scroll-state)<\/code> para gatear o CSS, e no JS use <code>CSS.supports('container-type', 'scroll-state')<\/code> para <em>n\u00e3o<\/em> rodar o IntersectionObserver em quem j\u00e1 tem o recurso nativo.<\/p>\n<pre><code>if (!CSS.supports('container-type', 'scroll-state')) {\n \/\/ mant\u00e9m o IntersectionObserver antigo s\u00f3 para Firefox e Safari\n initStickyObserver();\n}<\/code><\/pre>\n<p>Houve um projeto meu de dashboard financeiro em que a sombra do header sticky era controlada por uma classe <code>.is-stuck<\/code> aplicada via IntersectionObserver. Em telas com muitos widgets, o observer disparava enough para causar jank percept\u00edvel na rolagem. A alternativa era mover para CSS puro, o que na \u00e9poca (sem scroll-state) significava gambiarra. Hoje, para o subconjunto de usu\u00e1rios em Chromium, essa classe inteira some do bundle. O custo \u00e9 que a l\u00f3gica agora vive em dois lugares, CSS para quem suporta e JS para quem n\u00e3o, at\u00e9 Firefox e Safari alcan\u00e7arem.<\/p>\n<p>Outras armadilhas espec\u00edficas:<\/p>\n<ul>\n<li><strong>N\u00e3o confunda com container queries de tamanho.<\/strong> container-type: scroll-state \u00e9 separado de container-type: inline-size; voc\u00ea pode combinar: container-type: inline-size scroll-state. Se voc\u00ea precisa dos dois, declare os dois.<\/li>\n<li><strong>O container precisa ser o pr\u00f3prio sticky\/snap\/scroller.<\/strong> N\u00e3o adianta colocar <code>container-type: scroll-state<\/code> num ancestral do sticky. O container tem que ser o elemento cujo estado voc\u00ea quer observar.<\/li>\n<li><strong>Snapped exige scroll-snap configurado de verdade.<\/strong> Sem <code>scroll-snap-type<\/code> no pai e <code>scroll-snap-align<\/code> no filho, o estado nunca \u00e9 verdadeiro.<\/li>\n<\/ul>\n<h2>O que n\u00e3o d\u00e1 para afirmar ainda<\/h2>\n<p>Tr\u00eas pontos onde eu n\u00e3o arrisco firmeza. Um: n\u00e3o encontrei documenta\u00e7\u00e3o detalhada do <em>timing<\/em> exato das transi\u00e7\u00f5es de estado, ou seja, se <code>stuck: top<\/code> 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\u00e3o importa, mas para anima\u00e7\u00f5es precisas pode importar.<\/p>\n<p>Dois: o <code>scrolled<\/code>, por ser o descritor mais recente, tem menos relatos de uso em produ\u00e7\u00e3o. A documenta\u00e7\u00e3o \u00e9 clara sobre o que ele faz, mas n\u00e3o vi ainda uma an\u00e1lise de como ele se comporta com rolagens muito curtas, com <em>overscroll<\/em>, ou com trackpads que invertem a dire\u00e7\u00e3o.<\/p>\n<p>Tr\u00eas: o roadmap de Firefox e Safari. O bug <code>bugzil.la\/1931980<\/code> est\u00e1 aberto no Firefox, mas estimativa de ship \u00e9 tudo menos confi\u00e1vel. Quem precisa de paridade cross-browser deve planejar manter o fallback de JS pelo pr\u00f3ximo ano, no m\u00ednimo.<\/p>\n<h2>Como testar isso voc\u00ea mesmo<\/h2>\n<p>Um caminho de dez minutos. Crie um HTML com tr\u00eas se\u00e7\u00f5es altas e um header fixo:<\/p>\n<pre><code>&lt;!DOCTYPE html&gt;\n&lt;style&gt;\n body { margin: 0; font-family: system-ui; }\n .header-wrap {\n container-type: scroll-state;\n position: sticky;\n top: 0;\n background: white;\n }\n .header {\n padding: 1rem;\n transition: box-shadow 0.2s, background 0.2s;\n }\n section { height: 100vh; padding: 2rem; }\n section:nth-child(odd) { background: #f5f5f5; }\n\n @container scroll-state(stuck: top) {\n .header {\n box-shadow: 0 2px 10px rgba(0,0,0,0.15);\n background: #fffbe6;\n }\n }\n&lt;\/style&gt;\n\n&lt;div class=\"header-wrap\"&gt;\n &lt;header class=\"header\"&gt;Header que muda ao grudar&lt;\/header&gt;\n&lt;\/div&gt;\n&lt;section&gt;Role para baixo&lt;\/section&gt;\n&lt;section&gt;Continue rolando&lt;\/section&gt;\n&lt;section&gt;Role de volta ao topo&lt;\/section&gt;<\/code><\/pre>\n<p>Abra em Chrome 133 ou superior. No topo, o header \u00e9 branco e sem sombra. Role um pixel: fundo amarelo claro e sombra. Role de volta: volta ao estado inicial. Nenhum listener, nenhum observer.<\/p>\n<p>Depois, abra o mesmo arquivo em Firefox ou Safari. Observe que o header continua funcionando como sticky, s\u00f3 n\u00e3o ganha o destaque visual. Esse \u00e9 o teste real: se a sua interface sobrevive esse segundo cen\u00e1rio sem parecer quebrada, o enhancement pode ir pra produ\u00e7\u00e3o amanh\u00e3.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Como a query @container scroll-state() detecta sticky, snap e overflow direto em CSS, com c\u00f3digo, limites de suporte e um caminho de fallback que n\u00e3o quebra.<\/p>\n","protected":false},"author":2,"featured_media":804,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-805","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\/805","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=805"}],"version-history":[{"count":0,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts\/805\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media\/804"}],"wp:attachment":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media?parent=805"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/categories?post=805"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/tags?post=805"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}