Modo escuro no Tailwind CSS
VPS 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.
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
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.
Origem da preferência
O sistema ou a escolha manual indica o tema desejado.
Condição no documento
Uma consulta de mídia, classe ou atributo representa o estado.
Variante de tema
Os seletores gerados ativam os utilitários correspondentes.
Conferência de contraste
Textos, foco e controles são revisados sobre as superfícies reais.
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.