Ir para o conteúdo
Promovaweb

Modo escuro no Tailwind CSS

StayCloudVPS Agêntica

Uma VPS para os seus agentes trabalharem dia e noite

Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

Montar minha VPS Agêntica

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

O modo escuro do Tailwind CSS usa uma variante para aplicar estilos sob uma condição de tema. Por padrão, essa condição acompanha a preferência do sistema, mas pode ser redefinida por um seletor controlado pela aplicação.

Sumário da página

  1. A variante define quando o estilo escuro vale
  2. A seleção manual usa um seletor da aplicação
  3. O tema muda relações entre cores
  4. A primeira pintura também faz parte da experiência

A variante define quando o estilo escuro vale

A variante dark: permite associar um utilitário ao tema escuro. O componente pode declarar uma cor de texto para a apresentação básica e outra para a condição escura. A ferramenta gera os seletores ou as consultas necessários durante o build e o navegador aplica a alternativa que corresponde ao estado atual da página.

Na configuração padrão, a condição vem da preferência de esquema de cores do sistema. Você altera essa preferência no ambiente e o navegador a expõe à página por CSS. Esse caminho atende uma interface que acompanha automaticamente a escolha do sistema operacional. Ele não acrescenta um botão de alternância nem registra uma preferência particular para o seu site.

Essa diferença precisa ficar clara quando você desenha o controle de tema. O Tailwind fornece a forma de escrever os estilos condicionais. A aplicação define se existe uma escolha manual, onde ela é guardada e como é reaplicada nas próximas visitas. Um botão desenhado na tela não altera o tema até que sua implementação modifique o estado usado pelos estilos.

A seleção manual usa um seletor da aplicação

A documentação mostra como redefinir a variante com @custom-variant. Em vez de consultar somente a preferência do sistema, ela pode responder à presença de uma classe na árvore do documento. Outro caminho usa um atributo para representar o tema ativo. Os dois permitem que a aplicação controle a condição sem abandonar os utilitários do Tailwind.

  1. Origem da preferência

    O sistema ou a escolha manual indica o tema desejado.

  2. Condição no documento

    Uma consulta de mídia, classe ou atributo representa o estado.

  3. Variante de tema

    Os seletores gerados ativam os utilitários correspondentes.

  4. Conferência de contraste

    Textos, foco e controles são revisados sobre as superfícies reais.

O estilo escuro acompanha a preferência do sistema ou o seletor escolhido pela aplicação.

O seletor precisa corresponder à forma que o código realmente usa. Se os estilos consultam uma classe no elemento raiz, atualizar apenas um atributo diferente não ativa a variante. A conferência começa pelo estado visível no documento e continua até o seletor gerado. Conferir a classe ou o atributo no documento permite localizar a condição ausente e corrigir o seletor responsável pelo tema.

Você também pode oferecer três escolhas: claro, escuro e sistema. Nesse caso, o estado da aplicação distingue uma preferência explícita da ausência de escolha manual. O modo sistema precisa reagir à preferência do ambiente, enquanto os outros dois preservam a escolha da página. Essa lógica pertence à aplicação e deve ser testada junto da alternância visual.

O tema muda relações entre cores

Modo escuro não significa inverter todos os valores da página. Texto, fundo, borda, ícone e superfície precisam continuar distinguíveis entre si. Uma cor adequada para um link sobre papel claro pode ficar fraca sobre um painel escuro. O token da marca pode precisar de um valor diferente para a função de texto, preservando o matiz usado na identidade.

As superfícies também organizam a hierarquia. Um fundo de página e um cartão podem usar tons próximos, desde que suas bordas e seus conteúdos permaneçam legíveis. A mesma atenção vale para campos de formulário, mensagens e elementos selecionados. Conferir apenas o título principal deixa de fora uma parte grande da experiência real da interface.

Imagens e gráficos merecem leitura própria. Uma imagem com fundo claro pode parecer uma janela acidental no tema escuro, enquanto um ícone escuro pode desaparecer. O Tailwind permite aplicar estilos condicionais, mas não conhece a finalidade desses ativos. Você precisa escolher a apresentação adequada e manter texto alternativo e informação equivalente quando uma imagem muda entre os temas.

A primeira pintura também faz parte da experiência

Uma preferência registrada no armazenamento local precisa ser aplicada no momento adequado para evitar que a página apareça num tema e depois mude de forma abrupta. A documentação trata da aplicação da classe conforme a escolha registrada e a preferência do sistema. A posição desse código depende do framework e de como a página é entregue ao navegador.

O armazenamento pode não estar disponível e a aplicação precisa continuar utilizável nessa situação. A ausência de um valor registrado no armazenamento local também deve ter um significado definido, normalmente acompanhar o sistema. Essa implementação não precisa transformar uma preferência visual num requisito de cadastro ou numa informação enviada ao servidor, salvo quando o próprio produto exige esse comportamento.

Depois da alternância, percorra a página por teclado e confira foco, links, campos e mensagens nos dois temas. Uma cor de foco que funcionava no claro pode ficar pouco visível no escuro. Em responsivo e estados, você encontra a relação entre foco e largura. Em tema e design tokens, estão os valores que os componentes compartilham nos dois temas.