TailwindCSS Diterbitkan: • Diperbarui: • 4 menit baca • 3 views

Implementasi Dark Mode di Tailwind CSS Tanpa Flicker (FOUC): Sinkronisasi Sistem & localStorage

Juan Mths
Juan Mths
Chief Technology Officer & Administrator
Ilustrasi Implementasi Dark Mode di Tailwind CSS Tanpa Flicker (FOUC): Sinkronisasi Sistem & localStorage

Salah satu detail antarmuka yang langsung membedakan situs web rapi dengan situs yang terasa kurang matang adalah perilaku tema gelap (Dark Mode) saat halaman dimuat ulang. Banyak pengembang mengatur tema memakai JavaScript di dalam komponen Vue, React, atau file app.js yang memakai atribut defer. Hasilnya? Saat pengguna menekan Refresh di malam hari, layar sempat menyala putih terang selama sepersekian detik lalu tiba-tiba berkedip menjadi gelap—gejala yang dikenal sebagai FOUC (Flash of Unstyled Content).

Melanjutkan pembelajaran utilitas dasar pada panduan Tailwind CSS pemula dan token warna pada tutorial Custom Theme Tailwind CSS, panduan ini mempraktikkan konfigurasi Dark Mode berbasis kelas di Tailwind CSS v3/v4 yang benar-benar bebas kedipan dan menghormati preferensi sistem operasi pengguna.

1. Mengaktifkan Strategi Class di Tailwind CSS v4 & v3

Secara bawaan, utilitas dark:* di Tailwind CSS mengikuti media query CSS @media (prefers-color-scheme: dark). Agar pengguna dapat menekan tombol pengubah tema secara manual sekaligus tetap mendukung pengaturan bawaan OS sebagai nilai default, atur strategi varian ke mode selektor kelas .dark:

/* Tailwind CSS v4 (di berkas resources/css/app.css) */
@import "tailwindcss";
@custom-variant dark (&:where(.dark, .dark *));

/* Jika proyek Anda masih menggunakan Tailwind CSS v3 (tailwind.config.js): */
/* export default { darkMode: 'class', ... } */
Diagram urutan inisialisasi Dark Mode Tailwind CSS melalui skrip inline di head sebelum First Paint untuk mencegah kedipan layar putih FOUC
Skrip kecil sinkron di dalam <head> mengeksekusi penentuan kelas .dark sebelum browser menggambar piksel pertama, sehingga layar putih sesaat tidak pernah muncul.

2. Skrip Anti-Flicker Wajib di Dalam Bagian Head Dokumen

Mengapa skrip inisialisasi harus diletakkan sebagai blok <script> inline di dalam <head> (bukan di akhir <body> dan tanpa defer)? Karena browser menghentikan pembangunan <body> sejenak untuk menjalankan 10 baris kode super ringan ini, sehingga saat HTML konten mulai digambar, kelas .dark dan properti color-scheme sudah terpasang pada elemen <html>:

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <script>
    (function () {
      try {
        var saved = localStorage.getItem('theme');
        var prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
        var isDark = saved === 'dark' || (!saved && prefersDark);
        var root = document.documentElement;
        root.classList.toggle('dark', isDark);
        root.style.colorScheme = isDark ? 'dark' : 'light';
      } catch (e) {}
    })();
  </script>
  <link rel="stylesheet" href="/build/app.css">
</head>

Perhatikan baris root.style.colorScheme = isDark ? 'dark' : 'light'. Menyetel properti CSS standar color-scheme membuat bilah gulir (scrollbar), kotak centang bawaan browser, dan pemilih tanggal ikut berubah gelap selaras dengan latar Tailwind—tanpa meninggalkan scrollbar putih terang yang kontras di tepi kanan layar.

3. Pengelola Tombol Toggle & Sinkronisasi Perubahan Tema OS

Di file JavaScript utama (yang dimuat lewat Vite atau skrip tombol), siapkan pengontrol tiga status (Terang, Gelap, Ikuti Sistem) serta pendengar event change pada matchMedia agar halaman otomatis mengikuti pergantian tema otomatis siang/malam di Windows atau macOS ketika pengguna belum memilih mode manual:

// themeToggle.js
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');

export function applyThemePreference(mode) {
  if (mode === 'system') {
    localStorage.removeItem('theme');
  } else {
    localStorage.setItem('theme', mode);
  }

  const isDark = mode === 'dark' || (mode === 'system' && mediaQuery.matches);
  document.documentElement.classList.toggle('dark', isDark);
  document.documentElement.style.colorScheme = isDark ? 'dark' : 'light';
}

// Perbarui otomatis jika user mengubah tema OS & sedang memakai mode "system"
mediaQuery.addEventListener('change', (event) => {
  if (!localStorage.getItem('theme')) {
    document.documentElement.classList.toggle('dark', event.matches);
    document.documentElement.style.colorScheme = event.matches ? 'dark' : 'light';
  }
});

Perbandingan Tiga Pola Pengaturan Dark Mode Tailwind CSS

Pola Penerapan Dukung Tombol Manual? Bebas Flicker (FOUC)? Catatan
Hanya default prefers-color-scheme Tidak Ya Cocok bila Anda memang tidak menyediakan tombol pengubah tema sama sekali.
Toggle di bundle JS (defer / onMounted) Ya Tidak (layar berkedip saat F5) Sering menimbulkan kedipan putih mengganggu di mode gelap.
@custom-variant dark + skrip inline <head> Ya (Terang, Gelap, Sistem) Ya (0 ms kedipan) Standar terbaik; jangan lupa menyetel color-scheme serta mengecek kontras teks mode gelap.

Catatan terakhir: apabila situs Anda mengaktifkan header Content-Security-Policy (CSP) yang ketat tanpa 'unsafe-inline', sertakan hash SHA-256 atau nonce dinamis pada tag <script> inline di dalam <head> tersebut agar browser tepercaya tetap mengizinkan eksekusinya.

Diskusi & Komentar

0

Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.

Tulis Komentar
* Tautan dalam komentar otomatis diamankan dengan atribut rel="nofollow ugc". Maks 2.000 karakter
Komentar langsung terbit setelah lolos filter spam.

Belum Ada Komentar

Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!