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', ... } */

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
0Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.
Belum Ada Komentar
Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!