Ajuda

Unused CSS: tire as regras que seu HTML nunca usa

Para eliminar o unused CSS, cole o HTML de uma página (ou marcação JS) e a folha de estilo dela, clique em Limpar CSS e você recebe a folha de estilo sem as regras que nada na marcação consegue alcançar, com os bytes economizados à mostra. Você pode colar o texto ou carregá-lo com Escolher arquivo, até 5 MB por caixa. Tudo roda no seu navegador, então seu código não é enviado a lugar nenhum.


Como limpar o CSS a partir do seu HTML

  1. Cole seu HTML ou marcação JS em HTML / marcação, ou carregue com Escolher arquivo. Limpar esvazia uma caixa.
  2. Cole sua folha de estilo em Folha de estilo CSS do mesmo jeito.
  3. Se seus scripts adicionam classes enquanto a página roda, abra Avançado e liste essas classes em Lista de exceções.
  4. Clique em Limpar CSS. O botão fica desativado até as duas caixas terem texto.
  5. Leia CSS limpo e clique em Copiar para a área de transferência (vira Copiado) ou em Baixar CSS para salvar o arquivo limpo.css.
  6. Clique em Editar entrada para voltar com o texto preservado, por exemplo para acrescentar uma exceção e limpar de novo.

O resultado mostra uma linha como “NN% menor”, com os tamanhos Original e Limpo ao lado. Se nenhuma regra sobrar, você vê “Nenhuma regra restou.” Isso quase sempre quer dizer que a marcação e a folha de estilo são de páginas diferentes.

O que conta como regra sem uso

A ferramenta lê cada palavra da sua marcação e só mantém uma regra se todos os nomes de classe, ID, tag e atributo do seletor aparecerem lá. Nomes de classe e ID diferenciam maiúsculas de minúsculas. Pseudoclasses e pseudoelementos como :hover ou ::before nunca são exigidos, e o que estiver dentro de :not() ou :is() é ignorado.

Um exemplo: sua marcação tem um link com a classe btn e uma div com a classe card, e nenhuma outra classe. Veja o que acontece com as regras do seu CSS:

As regras dentro de @media, @supports, @layer e @container são limpas por dentro, e a regra @ só some quando não sobra nada nela. @font-face, @keyframes, @import, @charset, @page e @property ficam sempre, assim como :root, propriedades personalizadas, o seletor *, html e body.

Mantenha as classes que seu JavaScript adiciona

Abra Avançado para achar Lista de exceções. Digite as classes ou IDs que devem ficar mesmo fora do HTML, separados por vírgulas, por exemplo .modal, #nav, is-active. O ponto ou o # no início é opcional.

PurgeCSS online, purge CSS Tailwind, WordPress e várias páginas

Esta ferramenta faz o mesmo trabalho do PurgeCSS online, direto no navegador, como um unused CSS remover sem instalação. Uma folha de estilo costuma atender muitas páginas: cole a marcação de todas, uma depois da outra, em HTML / marcação, e uma regra fica se alguma página usar.

Para fazer o purge CSS Tailwind, cole seus templates e a folha de estilo gerada: seletores com escape, como md\:flex e w-1\/2, são comparados com os nomes de classe escritos na marcação.

Em um tema de WordPress, copie o código-fonte de cada tipo de página que o tema exibe e cole a folha de estilo do tema.

O que esta ferramenta não sabe

Ela não executa sua página nem seu JavaScript. Só lê o texto que você cola, então uma classe que aparece apenas em tempo de execução, ou em uma página que você não colou, é tratada como sem uso. Confira a folha de estilo limpa na página real antes de publicar.

As regras mantidas não são reformatadas nem minificadas, e os comentários são removidos, exceto os do tipo /*! license */. Uma folha de estilo que estava em uma linha continua em uma linha.

Para reduzir ainda mais o resultado, use o “Minificador de CSS”. Para adicionar prefixos de fornecedor, o “Autoprefixer CSS”, e para deixar legível um código minificado, o “Formatador de Código”.


Perguntas frequentes

Como tirar do CSS as regras que meu HTML não usa?

Cole o HTML da página em “HTML / marcação” e sua folha de estilo em “Folha de estilo CSS”, depois clique em “Limpar CSS”. “CSS limpo” mostra a folha de estilo sem cada regra que a marcação não alcança, mais a porcentagem economizada. Clique em “Copiar para a área de transferência” ou “Baixar CSS” (o arquivo se chama limpo.css) e troque a folha de estilo antiga.

Existe um PurgeCSS online?

Esta é uma ferramenta online para o mesmo trabalho. Ela lê cada palavra da sua marcação e só mantém uma regra se cada nome de classe, ID, tag e atributo do seletor aparecer lá. Não é o pacote PurgeCSS, então não tem arquivo de configuração nem plugins, e não executa sua página. O campo “Lista de exceções” cobre a única opção de que a maioria das pessoas precisa.

Como encontrar as classes CSS que ninguém usa?

Clique em “Limpar CSS” e compare o resultado com o original. Qualquer classe que sumiu de “CSS limpo” não tinha correspondência na marcação que você colou. A ferramenta não lista as regras removidas, então, numa folha de estilo longa, vale olhar primeiro os tamanhos “Original” e “Limpo” e depois conferir o que está faltando.

Como manter as classes que o JavaScript adiciona depois?

Abra “Avançado” e digite-as no campo “Lista de exceções”, separadas por vírgulas, por exemplo .modal, #nav, is-active. O ponto ou o # no início é opcional. As regras que citam uma classe ou ID da lista ficam, mas o resto do seletor ainda precisa combinar: .menu.is-active só fica se menu também aparecer na marcação. Se o seu JavaScript faz parte do que você cola em “HTML / marcação”, os nomes de classe escritos por extenso ali são encontrados sem a lista de exceções.

Por que uma classe que meu script adiciona foi removida do CSS?

A ferramenta não executa sua página nem seu JavaScript. Ela só lê o texto que você cola, então um nome montado em tempo de execução, como 'btn-' + size, nunca aparece e suas regras são removidas. Cole o script em “HTML / marcação” e escreva ali os nomes de classe completos, ou adicione-os à “Lista de exceções”. Depois confira o resultado na página antes de publicar.

Como fazer o purge CSS do Tailwind?

Cole seus templates ou componentes em “HTML / marcação” e a folha de estilo gerada do Tailwind em “Folha de estilo CSS”. Seletores com escape, como md\:flex e w-1\/2, são comparados com os nomes de classe escritos na marcação, então essas utilities ficam quando você as usa. Nomes de classe montados no código, como 'bg-' + color + '-500', não são encontrados: escreva-os por inteiro ou coloque-os na lista de exceções.

Como enxugar o CSS de um tema de WordPress sem plugin?

Abra uma página, veja o código-fonte, copie o HTML e cole em “HTML / marcação”. Cole a folha de estilo do seu tema em “Folha de estilo CSS” e clique em “Limpar CSS”. A folha de estilo de um tema é compartilhada por muitas páginas, então cole o HTML de várias páginas diferentes, uma depois da outra, na mesma caixa: uma regra fica se alguma delas a usar. Troque o arquivo só depois de conferir cada tipo de página.

Tirar o que não é usado também minifica o CSS?

Não. As regras mantidas ficam como você escreveu, sem reformatação nem minificação, e uma folha de estilo de uma linha continua com uma linha. Os comentários são removidos, exceto os do tipo /*! license */. Para reduzir mais o arquivo, passe o resultado pelo “Minificador de CSS”.

Meu HTML ou CSS é enviado para algum lugar?

Não. A limpeza roda em um Web Worker no seu navegador, então a marcação e a folha de estilo ficam no seu dispositivo. Cada caixa aceita até 5 MB.