
Modo escuro com Tailwind CSS
Vamos adicionar um botão para alternar entre os modos claro e escuro e guardar essa escolha no navegador. O exemplo usa Tailwind CSS v3 e TypeScript.
O modo escuro pode ser mais confortável dependendo da iluminação e da preferência de quem usa a página. O cansaço visual também depende de fatores como brilho, contraste e tempo de uso, como explica a Academia Americana de Oftalmologia. A economia de bateria depende da tela e do brilho: a pesquisa da Purdue mediu esse efeito em celulares com telas OLED.
O Tailwind permite aplicar estilos com classes utilitárias no HTML. Aqui, vamos usar a variante dark: para definir o que muda quando o modo escuro está ativo.
Se você ainda não configurou o Tailwind, siga a documentação de instalação da v3. A documentação atual usa outra versão; este tutorial mantém a configuração da v3.
O exemplo segue este layout simples. Você pode abrir a página funcionando e acompanhar o código no GitHub.
Configurando o tema
Passo 1: Configurar as cores do modo escuro
Você pode usar as cores que o Tailwind já oferece ou definir uma paleta própria no arquivo de configuração. Para este layout, as cores do modo escuro são:
colors: {
dark: {
'primary': '#EAE9FF',
'secondary': '#B19EF4',
'background': '#413B5E',
}
}
No arquivo de configuração exportado com module.exports, vamos agrupar cada cor com sua variação escura. O trecho acima apresenta a paleta; a configuração completa abaixo organiza os nomes usados nas classes do exemplo:
module.exports = {
content: ['./app/**/*.{html,js,ts,jsx,tsx}'],
darkMode: 'class',
theme: {
extend: {
colors: {
primary: {
DEFAULT: '#FFB25A',
dark: '#EAE9FF',
},
secondary: {
DEFAULT: '#FFF0CE',
dark: '#B19EF4',
},
background: {
DEFAULT: '#FFFDEB',
dark: '#413B5E',
},
},
},
},
plugins: [],
};
Com darkMode: 'class', adicionar a classe dark ao elemento html ativa os estilos do modo escuro. Esta é a estratégia usada no exemplo; a documentação da v3 passou a recomendar selector a partir da versão 3.4.1.
Passo 2: Adicionar estilos para o modo escuro
No HTML, dark:bg-background-dark aplica a cor de fundo escura ao body quando o tema está ativo:
<body class="bg-background dark:bg-background-dark">
<!-- meu conteúdo -->
</body>
A classe bg-background mantém a cor de fundo do modo claro.
Passo 3: Adicionar um botão de alternância para o modo escuro
O botão vai adicionar ou remover a classe dark do html a cada clique. Crie o arquivo dark-mode-manager.ts com o código:
class DarkModeManager {
constructor() {
const toggleDarkModeButton = document.getElementById(
'toggle-theme'
) as HTMLButtonElement | null;
if (toggleDarkModeButton) {
toggleDarkModeButton.addEventListener('click', this.handleToggleDarkMode);
}
if (this.getDarkModeState()) {
this.setDarkMode(true);
}
}
private getDarkModeState(): boolean {
const darkMode = localStorage.getItem('darkMode');
return darkMode === 'true';
}
private setDarkMode(darkMode: boolean): void {
localStorage.setItem('darkMode', String(darkMode));
const html = document.documentElement;
if (darkMode) {
html.classList.add('dark');
} else {
html.classList.remove('dark');
}
}
private handleToggleDarkMode = (): void => {
const isDarkMode = this.getDarkModeState();
this.setDarkMode(!isDarkMode);
};
}
const darkModeManager = new DarkModeManager();
O DarkModeManager salva a escolha no localStorage, aplica ou remove a classe dark e recupera o tema salvo quando a página abre novamente.
Adicione o botão ao HTML com o mesmo ID usado no código:
<button id="toggle-theme">Alternar modo claro/escuro</button>
Se o ambiente de desenvolvimento transforma TypeScript em JavaScript, você pode referenciar o arquivo de entrada no HTML assim:
<script src="dark-mode-manager.ts" type="module"></script>
O atributo type="module" indica um módulo JavaScript. Ele não faz o navegador executar TypeScript: o arquivo precisa ser convertido para JavaScript pela ferramenta de desenvolvimento. Se você compila os arquivos separadamente, use no src o caminho do .js gerado. A introdução ao TypeScript explica essa conversão.
Com a página aberta pelo ambiente de desenvolvimento, clique no botão e depois recarregue: o tema escolhido deve continuar ativo. As cores da página e o estilo do botão podem ser ajustados ao seu layout.