{"id":831,"date":"2026-11-10T18:32:32","date_gmt":"2026-11-10T21:32:32","guid":{"rendered":"https:\/\/yellowkode.com\/blog\/udjo-css-deduplicacao-declaracoes-2026\/"},"modified":"2026-11-10T18:32:32","modified_gmt":"2026-11-10T21:32:32","slug":"udjo-css-deduplicacao-declaracoes-2026","status":"publish","type":"post","link":"https:\/\/yellowkode.com\/blog\/udjo-css-deduplicacao-declaracoes-2026\/","title":{"rendered":"UDJO em CSS: Deduplica\u00e7\u00e3o de Declara\u00e7\u00f5es em 2026"},"content":{"rendered":"<p>Em 10 de novembro de 2026, Jens Oliver Meiert publicou no CSS-Tricks um artigo revisitando uma t\u00e9cnica de otimiza\u00e7\u00e3o de CSS com pelo menos dezoito anos de idade: UDJO, usando declara\u00e7\u00f5es apenas uma vez. A pergunta do texto \u00e9 direta: isso ainda funciona hoje? Para responder, ele construiu uma ferramenta, o CSS Dedup, e rodou medi\u00e7\u00f5es em trinta sites. Este artigo pega essa medi\u00e7\u00e3o, explica o mecanismo por tr\u00e1s dela e mostra onde a t\u00e9cnica compensa e onde ela custa mais bytes do que economiza.<\/p>\n<h2>O que \u00e9 UDJO, em uma frase que importa<\/h2>\n<p>UDJO significa usar cada declara\u00e7\u00e3o CSS uma \u00fanica vez. Declara\u00e7\u00e3o aqui \u00e9 o par propriedade mais valor, tipo <code>display: flex<\/code>. Se esse par aparece em duas regras diferentes, UDJO manda juntar os seletores dessas regras e deixar a declara\u00e7\u00e3o em um lugar s\u00f3.<\/p>\n<p>Antes:<\/p>\n<pre><code>.example { display: flex; }\n.sample { display: flex; }<\/code><\/pre>\n<p>Depois:<\/p>\n<pre><code>.example, .sample { display: flex; }<\/code><\/pre>\n<p>A t\u00e9cnica \u00e9 uma aplica\u00e7\u00e3o do princ\u00edpio DRY ao CSS que funciona porque evitar repeti\u00e7\u00e3o de declara\u00e7\u00e3o costuma ser mais efetivo do que evitar repeti\u00e7\u00e3o de seletor, j\u00e1 que declara\u00e7\u00f5es s\u00e3o frequentemente mais longas. Esse \u00e9 o ponto de mec\u00e2nica que decide tudo: toda vez que voc\u00ea junta duas regras, voc\u00ea paga o pre\u00e7o de repetir o seletor na lista. Se os seletores somados s\u00e3o menores que a declara\u00e7\u00e3o que voc\u00ea economizou, voc\u00ea ganha bytes. Se s\u00e3o maiores, voc\u00ea perde.<\/p>\n<h2>Como o CSS Dedup decide o que deduplicar<\/h2>\n<p>O CSS Dedup \u00e9 a ferramenta que Meiert publicou junto com o artigo. Ela encontra declara\u00e7\u00f5es duplicadas e, quando solicitado e onde \u00e9 seguro, consolida: o mesmo par normalizado propriedade e valor n\u00e3o deveria aparecer em mais de uma regra dentro do mesmo escopo.<\/p>\n<p>A parte interessante \u00e9 por que ela n\u00e3o sai consolidando tudo. Juntar duas regras muda a posi\u00e7\u00e3o delas no documento, e posi\u00e7\u00e3o no CSS importa por causa da cascata. Se <code>.a<\/code> est\u00e1 no topo do arquivo e <code>.b<\/code> est\u00e1 no fim, e no meio tem outra regra que redefine a mesma propriedade em um desses seletores, mover <code>.a<\/code> para junto de <code>.b<\/code> pode mudar o que acaba aplicado na tela. Por isso o texto no CSS-Tricks diz que deduplica\u00e7\u00e3o afeta localiza\u00e7\u00e3o de seletores, o que, pela cascata, influencia que regras s\u00e3o aplicadas.<\/p>\n<p>Pense no CSS como uma fila de atendimento onde quem chega por \u00faltimo fala mais alto, mas s\u00f3 se estiver falando da mesma coisa. Trocar a ordem da fila s\u00f3 importa quando duas pessoas est\u00e3o discutindo o mesmo ponto. A ferramenta precisa olhar para toda a fila antes de decidir se pode trocar algu\u00e9m de lugar. A analogia quebra num detalhe: na cascata, especificidade do seletor tamb\u00e9m entra, n\u00e3o \u00e9 s\u00f3 ordem. Mas para entender por que a ferramenta precisa ser conservadora, serve.<\/p>\n<h3>Os dois modos do CSS Dedup<\/h3>\n<p>A ferramenta trabalha em dois modos principais. O modo padr\u00e3o de inspe\u00e7\u00e3o roda com <code>npx css-dedup<\/code> e s\u00f3 reporta. O interessante \u00e9 o modo que corrige apenas quando reduz o tamanho do arquivo:<\/p>\n<pre><code>npx css-dedup --fix --savings-only .<\/code><\/pre>\n<p>Esse comando \u00e9 documentado pelo pr\u00f3prio autor como a op\u00e7\u00e3o para corrigir duplica\u00e7\u00e3o onde \u00e9 seguro e apenas quando h\u00e1 economia de bytes. A ferramenta tamb\u00e9m pode ser usada programaticamente e como plugin do PostCSS, o que significa que d\u00e1 para plugar ela no build sem reescrever pipeline.<\/p>\n<p>O trade-off que a pr\u00f3pria documenta\u00e7\u00e3o do CSS Dedup declara \u00e9 importante: dobrar uma declara\u00e7\u00e3o em uma lista de seletores compartilhada adiciona os bytes dessa lista de volta, ent\u00e3o consolidar uma declara\u00e7\u00e3o que s\u00f3 tem em comum alguns seletores longos e sem outra rela\u00e7\u00e3o pode acabar custando mais do que remove; os dois modos do CSS Dedup chamam isso \u00e0 aten\u00e7\u00e3o para que seja uma decis\u00e3o consciente, que vale a pena se voc\u00ea valoriza usar declara\u00e7\u00e3o uma vez por manutenibilidade, mas n\u00e3o se est\u00e1 otimizando puramente para tamanho de transfer\u00eancia.<\/p>\n<p>Isso \u00e9 um sistema que declara onde para e n\u00e3o te pune por isso. Ele mostra os dois cen\u00e1rios e deixa voc\u00ea escolher.<\/p>\n<h2>O que a medi\u00e7\u00e3o em 30 sites mostrou<\/h2>\n<p>O artigo rodou a ferramenta em 20 sites de organiza\u00e7\u00f5es e 10 sites de desenvolvedores web conhecidos. A pergunta era: d\u00e1 para deduplicar? E d\u00e1 para deduplicar economizando bytes?<\/p>\n<p>Nos 20 sites de organiza\u00e7\u00f5es, aplicar UDJO de forma natural (todos os pares seguros) <strong>aumentou<\/strong> o arquivo em 18 dos 20 casos. Em eff.org, por exemplo, o CSS cresceu 120,8 KB, ou 27,7%. Em die-linke.de, cresceu 104 KB (20,5%). Isso acontece porque, como explicamos acima, o custo dos seletores repetidos superou o ganho das declara\u00e7\u00f5es consolidadas.<\/p>\n<p>Mas o segundo modo, o <code>--savings-only<\/code>, reduziu o tamanho do arquivo em <strong>todos<\/strong> os 20 sites. Modesto em muitos (0,2% no 12371.cn), relevante em outros (7,2% no globalsumudflotilla.org, 5,9% no nam.go.ug, 5,1% no commission.europa.eu).<\/p>\n<p>Nos 10 sites de desenvolvedores, o padr\u00e3o foi parecido mas atenuado. Em todo site h\u00e1 alguma repeti\u00e7\u00e3o de declara\u00e7\u00e3o segura de remover, mas s\u00f3 em 5 dos 10 o modo natural aumentou o arquivo (contra 90% no grupo anterior). Em todos os 10, o modo com economia conseguiu reduzir bytes. sarasoueidan.com teve o maior corte, 11,1%, 4,5 KB.<\/p>\n<p>O que isso diz na pr\u00e1tica: UDJO ainda funciona como vetor de otimiza\u00e7\u00e3o, mas s\u00f3 se voc\u00ea usa a op\u00e7\u00e3o que mede ganho antes de aplicar. Sem isso, a chance de o arquivo ficar maior \u00e9 alta em bases grandes.<\/p>\n<h2>O que isso significa quando voc\u00ea tem um design system<\/h2>\n<p>Aqui vale um aviso de contexto, j\u00e1 que estou publicando design system e style guide de interface. A escolha entre deduplicar por manuten\u00e7\u00e3o ou deduplicar por bytes depende de quem l\u00ea o CSS depois.<\/p>\n<p>Se o arquivo \u00e9 gerado por build a partir de tokens e componentes, o CSS final n\u00e3o \u00e9 lido por humano nenhum e voc\u00ea deveria estar otimizando para transfer\u00eancia: rode <code>--savings-only<\/code> depois da minifica\u00e7\u00e3o. A deduplica\u00e7\u00e3o nesse ponto \u00e9 s\u00f3 mais uma passada de compress\u00e3o sem\u00e2ntica em cima do que o Brotli vai comprimir de novo.<\/p>\n<p>Se o arquivo \u00e9 escrito \u00e0 m\u00e3o e lido para manuten\u00e7\u00e3o, o c\u00e1lculo inverte. Consolidar seletores em uma \u00fanica regra significa que quando voc\u00ea mudar <code>display: flex<\/code> para <code>display: grid<\/code>, voc\u00ea vai mexer num lugar s\u00f3. Mas isso \u00e9 verdade s\u00f3 se a mudan\u00e7a de uma declara\u00e7\u00e3o puder de fato ser aplicada a todos os seletores agrupados, e \u00e9 isso que determina se UDJO leva a uma vantagem real de manutenibilidade. Se amanh\u00e3 metade daqueles seletores precisa de <code>display: grid<\/code> e metade continua em <code>display: flex<\/code>, voc\u00ea desagrupa de novo e volta ao in\u00edcio.<\/p>\n<h2>Onde a t\u00e9cnica quebra<\/h2>\n<p>Quatro limites concretos.<\/p>\n<p><strong>Um.<\/strong> Bases grandes com seletores longos (BEM profundo, classes utilit\u00e1rias longas, prefixos de componente) tendem a perder bytes quando deduplicadas sem o filtro de economia. Isso est\u00e1 nos dados: 90% dos sites de organiza\u00e7\u00e3o ficaram maiores no modo natural.<\/p>\n<p><strong>Dois.<\/strong> A ferramenta n\u00e3o distingue inten\u00e7\u00e3o. Ferramentas como o CSS Dedup n\u00e3o fazem diferen\u00e7a entre casos de uso de declara\u00e7\u00e3o e s\u00e3o portanto grosseiras, mas \u00e9 poss\u00edvel configur\u00e1-las para colher os benef\u00edcios de performance. Se duas regras compartilham <code>color: #333<\/code> por coincid\u00eancia, a ferramenta vai juntar as duas, e voc\u00ea vai ter que lembrar de desagrupar quando o design mudar uma das duas.<\/p>\n<p><strong>Tr\u00eas.<\/strong> O ganho precisa ser medido contra compress\u00e3o. O texto mesmo reconhece que esses valores n\u00e3o foram testados com compress\u00e3o adicional e seria justo test\u00e1-los tamb\u00e9m. Gzip e Brotli j\u00e1 s\u00e3o muito bons em comprimir repeti\u00e7\u00e3o textual. \u00c9 bem poss\u00edvel que ganhos de 5% antes da compress\u00e3o virem 1% depois. O artigo n\u00e3o cobre isso, e eu tamb\u00e9m n\u00e3o testei.<\/p>\n<p><strong>Quatro.<\/strong> UDJO n\u00e3o substitui custom properties, vari\u00e1veis ou qualquer camada de abstra\u00e7\u00e3o sem\u00e2ntica. Juntar <code>color: #333<\/code> de dois seletores \u00e9 diferente de ter <code>--text-primary<\/code>. A segunda carrega inten\u00e7\u00e3o, a primeira carrega valor.<\/p>\n<h2>O que ainda n\u00e3o d\u00e1 para afirmar<\/h2>\n<p>A amostra do artigo tem 30 sites, escolhidos arbitrariamente, e valeria expandir essa an\u00e1lise com mais amostras e investigar diferen\u00e7as entre elas. Tamb\u00e9m n\u00e3o sabemos o efeito depois de Brotli, como mencionei. E n\u00e3o sabemos quanto da economia sobrevive quando o pipeline j\u00e1 tem PostCSS, Lightning CSS, cssnano ou similares rodando. Pode ser que boa parte da duplica\u00e7\u00e3o encontrada j\u00e1 seja consolidada por essas ferramentas em outro passo, ou pode ser que elas n\u00e3o toquem nisso. O artigo n\u00e3o compara.<\/p>\n<h2>Como testar isso voc\u00ea mesmo<\/h2>\n<p>Pegue o CSS de um site seu, idealmente o arquivo j\u00e1 minificado de produ\u00e7\u00e3o. Rode em dois passos.<\/p>\n<p>Primeiro, s\u00f3 o relat\u00f3rio:<\/p>\n<pre><code>npx css-dedup caminho\/para\/styles.css<\/code><\/pre>\n<p>Veja quantas declara\u00e7\u00f5es est\u00e3o repetidas. Depois, o modo que s\u00f3 corrige quando economiza:<\/p>\n<pre><code>npx css-dedup --fix --savings-only caminho\/para\/styles.css<\/code><\/pre>\n<p>Compare o tamanho antes e depois. Depois comprima os dois arquivos com Brotli ou gzip e compare de novo. \u00c9 o n\u00famero que importa de verdade, porque \u00e9 o que vai pela rede. Se a diferen\u00e7a comprimida for menor que 1% e voc\u00ea tem design system com time consumindo, provavelmente o ganho n\u00e3o paga o ru\u00eddo no diff do PR. Se \u00e9 um site est\u00e1tico, HTML gerado, CSS escrito \u00e0 m\u00e3o, qualquer economia antes de compress\u00e3o tende a virar alguma economia depois.<\/p>\n<p>Para fechar: UDJO n\u00e3o \u00e9 truque novo, \u00e9 t\u00e9cnica velha com ferramenta nova. O que o artigo do Meiert adiciona \u00e9 a medida. A medida diz que a t\u00e9cnica funciona, mas s\u00f3 se voc\u00ea aceita que ela tamb\u00e9m pode piorar o arquivo quando aplicada sem cuidado. Essa honestidade sobre quando o pr\u00f3prio m\u00e9todo quebra \u00e9 a parte que vale copiar, independentemente de voc\u00ea usar CSS Dedup ou n\u00e3o.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Como funciona a t\u00e9cnica UDJO em CSS, o que o CSS Dedup mede, quando deduplicar economiza bytes e quando aumenta o arquivo.<\/p>\n","protected":false},"author":2,"featured_media":830,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-831","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\/831","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=831"}],"version-history":[{"count":0,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/posts\/831\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media\/830"}],"wp:attachment":[{"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/media?parent=831"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/categories?post=831"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/yellowkode.com\/blog\/wp-json\/wp\/v2\/tags?post=831"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}