Pular para o conteúdo principal

Modo escuro com Tailwind CSS

Modo escuro com Tailwind CSS

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.

Fontes

Voltar