Кнопку «Темний режим» я переробляв на своїх сайтах уже кілька разів. Спершу були два окремі файли стилів і запис у cookies з перезавантаженням сторінки, потім – клас на тезі <html> і localStorage. Відтоді браузери навчилися самі знати, яку тему обрав користувач у системі, а CSS отримав зручні інструменти саме для цього. Тож розповім, як сьогодні зробити темну тему на сайті: щоб вона вмикалася сама разом із системною, мала кнопку перемикання, запам'ятовувала вибір і не блимала білим при завантаженні.

Крок 1: кольори через змінні

Основа всього – не прописувати кольори по всьому CSS, а винести їх у CSS-змінні. Тоді для темної теми достатньо змінити кілька значень, а не переписувати пів файлу стилів.

:root {
    color-scheme: light dark;
    --text: light-dark(#282c34, #d4d4d4);
    --bg: light-dark(#ffffff, #1e2127);
    --accent: light-dark(#34687d, #7fb8cf);
}

body {
    color: var(--text);
    background: var(--bg);
}

a {
    color: var(--accent);
}

Тут дві нові для багатьох речі:

  • color-scheme: light dark каже браузеру, що сайт уміє обидві теми. Він сам підлаштує під них поля форм, смуги прокрутки й інші стандартні елементи, які ти не стилізуєш.
  • light-dark() повертає перший колір для світлої теми і другий для темної. А яка тема зараз – браузер вирішує сам за налаштуваннями системи.

І це все! Без жодного рядка JavaScript сайт уже перемикається разом із системою: увімкнув/ла на телефоні нічний режим – і сайт потемнішав.

Якщо потрібна підтримка старіших браузерів

Функцію light-dark() підтримують усі сучасні браузери, але якщо твої відвідувачі сидять на дуже старих, той самий результат дає медіазапит prefers-color-scheme:

:root {
    --text: #282c34;
    --bg: #ffffff;
}

@media (prefers-color-scheme: dark) {
    :root:not([data-theme="light"]) {
        --text: #d4d4d4;
        --bg: #1e2127;
    }
}

:root[data-theme="dark"] {
    --text: #d4d4d4;
    --bg: #1e2127;
}

Кольори темної теми тут доводиться писати двічі: для системного темного режиму і для ручного вибору. Тому, якщо можна, я беру light-dark().

Крок 2: ручний вибір теми

Не всі хочуть, щоб сайт повторював систему: хтось удень працює в темній темі, а хтось увечері любить білий фон. Тож даємо можливість вибрати вручну. Вибір позначатимемо атрибутом data-theme на тезі <html>, а в CSS для цього вистачить двох рядків:

:root[data-theme="light"] { color-scheme: light; }
:root[data-theme="dark"]  { color-scheme: dark; }

Ось тут light-dark() і показує свою силу: ми міняємо лише color-scheme, а всі кольори на сайті перемикаються самі.

Кнопка в розмітці:

<button class="theme-toggle" type="button" aria-label="Темна тема" aria-pressed="false">🌙</button>

Атрибут aria-pressed підказує програмам для незрячих, увімкнена темна тема чи ні, а aria-label дає кнопці зрозумілу назву, бо сама іконка нічого не скаже.

Крок 3: запам'ятовуємо вибір у localStorage

localStorage – це сховище в браузері, куди скрипт може записати пару «ключ – значення», і вона залишиться там і після перезавантаження сторінки, і після закриття браузера. Для запам'ятовування теми – саме те, що треба.

const toggle = document.querySelector('.theme-toggle');
const root = document.documentElement;
const systemDark = matchMedia('(prefers-color-scheme: dark)');

function currentTheme() {
    return root.dataset.theme || (systemDark.matches ? 'dark' : 'light');
}

function updateButton() {
    const isDark = currentTheme() === 'dark';
    toggle.setAttribute('aria-pressed', isDark);
    toggle.textContent = isDark ? '☀️' : '🌙';
}

toggle.addEventListener('click', () => {
    const next = currentTheme() === 'dark' ? 'light' : 'dark';
    root.dataset.theme = next;
    try {
        localStorage.setItem('theme', next);
    } catch (e) {}
    updateButton();
});

systemDark.addEventListener('change', updateButton);
updateButton();

Що тут відбувається:

  • currentTheme() бере тему, яку обрав відвідувач, а якщо він нічого не обирав – системну. Системну тему JavaScript дізнається через matchMedia().
  • Клацання по кнопці перемикає тему на протилежну, ставить атрибут data-theme і записує вибір у localStorage.
  • try потрібен тому, що в деяких браузерах у приватному режимі запис у localStorage може видати помилку. Тема тоді просто не запам'ятається, але сайт не зламається.
  • Якщо відвідувач змінить тему в системі, поки сторінка відкрита, кнопка оновить свою іконку.

Хочеш дати можливість повернутися до системної теми? Додай ще одну кнопку, яка видаляє вибір: localStorage.removeItem('theme') і delete root.dataset.theme.

Крок 4: щоб сторінка не блимала білим

Якщо підключити скрипт вище в кінці сторінки, при кожному переході браузер спершу покаже сторінку в системній темі, а вже потім скрипт прочитає вибір і перемкне її. Виходить неприємне блимання, особливо коли в темряві раптом спалахує білий екран. Тому збережений вибір треба відновити якомога раніше – маленьким скриптом прямо в <head>, ще до стилів:

<script>
    try {
        const saved = localStorage.getItem('theme');
        if (saved) document.documentElement.dataset.theme = saved;
    } catch (e) {}
</script>

Це той рідкісний випадок, коли скрипт варто вписати просто в HTML, а не підключати окремим файлом: він крихітний і мусить спрацювати до того, як браузер почне малювати сторінку. Решта коду з кроку 3 може лежати в окремому файлі з атрибутом defer.

localStorage чи cookies?

Темну тему можна запам'ятовувати і в cookies – так я колись і робив. Перевага cookies в тому, що браузер відправляє їх на сервер, і той одразу віддає сторінку з потрібною темою, тож скрипт у <head> не потрібен. Як це зробити на PHP, я показував у статті cookies у JavaScript: як записати і прочитати. Готовий приклад для WordPress, де PHP читає куку і одразу ставить тему на тег <html>, є в статті темний режим у темі WordPress. А якщо сайт статичний або тобі просто не хочеться чіпати серверну частину, localStorage – простіший варіант.

Що далі

Якщо тобі зручніше перемикати тему класом, а не атрибутом, глянь, як змінити клас елемента в JavaScript – CSS тоді буде :root.dark замість :root[data-theme="dark"]. Замість емодзі на кнопку можна поставити іконки сонця й місяця з Font Awesome. А поруч із перемикачем теми на телефоні зазвичай живе меню – ось як зробити кнопку-бургер на CSS.

А щоб сайт виглядав доглянуто в обох темах, підбери йому гарний шрифт – про це стаття шрифт для сайту: Google Fonts, Font Squirrel і @font-face.

Для розташування елементів по центру є окремий розбір: усі способи відцентрувати div.

А на твоєму сайті вже є темна тема? Вона вмикається сама чи тільки кнопкою? Пиши в коментарях 🙂