Kurs JavaScript i React · Moduł 14: Zaawansowane stylowanie

Theming w Styled-components - Galaktyczny System Designu

5 min czytania ·
W tej lekcji7

Wyobraź sobie flotę, w której każdy statek ma inny odcień fioletu na przyciskach alarmowych, bo każdy inżynier wpisał kolor z pamięci. Gdy dowództwo postanowi zmienić barwy floty, ktoś będzie musiał przeszukać setki plików i poprawić każdą wartość #7c4dff ręcznie. Tak wygląda projekt bez motywu. ThemeProvider w styled-components pozwala na stworzenie spójnego systemu kolorów, rozmiarów i typografii - jak ujednolicony interfejs dla całej floty kosmicznej.

Zanim zaczniemy, jedna uczciwa uwaga. W marcu 2025 opiekun biblioteki ogłosił, że styled-components przechodzi w tryb utrzymania: dostaje poprawki błędów, ale nie nowe funkcje, a do nowych projektów autor sam go nie poleca. Biblioteka (aktualnie wersja 6) nadal działa w ogromnej liczbie istniejących aplikacji, więc warto ją znać, a idea motywu, której się tu nauczysz, przenosi się jeden do jednego na CSS Variables i inne narzędzia.

ThemeProvider

ThemeProvider to komponent, który udostępnia motyw (theme) wszystkim komponentom wewnątrz. Pod spodem korzysta z kontekstu React, więc motyw dociera na dowolną głębokość bez przekazywania propsów. Sam motyw to zwykły obiekt JavaScript, w którym grupujemy wartości według kategorii: kolory, odstępy, zaokrąglenia i rozmiary czcionek:

import { ThemeProvider } from 'styled-components';

const spaceTheme = {
  colors: {
    primary: '#7c4dff',
    secondary: '#64b5f6',
    background: '#0a0a2e',
    surface: '#1a1a4e',
    text: '#e0e0e0',
    success: '#00e676',
    warning: '#ffa726',
    danger: '#f44336',
  },
  spacing: {
    xs: '4px',
    sm: '8px',
    md: '16px',
    lg: '24px',
    xl: '32px',
  },
  borderRadius: {
    sm: '4px',
    md: '8px',
    lg: '12px',
    round: '50%',
  },
  fontSize: {
    sm: '12px',
    md: '16px',
    lg: '20px',
    xl: '28px',
  },
};

function App() {
  return (
    <ThemeProvider theme={spaceTheme}>
      <Dashboard />
    </ThemeProvider>
  );
}

ThemeProvider niczego nie renderuje w DOM i nie zmienia wyglądu Dashboard sam z siebie. Tylko udostępnia obiekt, a komponenty muszą z niego skorzystać. Nazwy kluczy, takie jak colors czy spacing, wymyślasz sam, biblioteka nie narzuca żadnej struktury.

Używanie motywu w komponentach

Każdy styled-component ma automatyczny dostęp do motywu przez props.theme. Wewnątrz szablonu stylu wstawiasz funkcję w ${...}, a biblioteka wywoła ją z propsami komponentu:

const Panel = styled.div`
  background: ${props => props.theme.colors.surface};
  border-radius: ${props => props.theme.borderRadius.lg};
  padding: ${props => props.theme.spacing.lg};
  color: ${props => props.theme.colors.text};
`;

const Heading = styled.h2`
  color: ${({ theme }) => theme.colors.primary};
  font-size: ${({ theme }) => theme.fontSize.xl};
  margin-bottom: ${({ theme }) => theme.spacing.md};
`;

Zwróć uwagę na destrukturyzację - ({ theme }) to skrót od (props) => props.theme. Oba zapisy działają identycznie, ale polecam drugi, bo przy wielu wartościach jest krótszy i czytelniejszy. W żadnym z tych komponentów nie ma już ani jednego zakodowanego koloru.

Przełączanie motywów (Dark/Light)

Jedno z najpopularniejszych zastosowań ThemeProvider to przełączanie między ciemnym a jasnym motywem. Definiujemy dwa obiekty o tych samych kluczach, a stan isDark wybiera, który trafi do providera:

const darkTheme = {
  colors: {
    background: '#0a0a2e',
    surface: '#1a1a4e',
    text: '#e0e0e0',
    primary: '#7c4dff',
  },
};

const lightTheme = {
  colors: {
    background: '#f5f5f5',
    surface: '#ffffff',
    text: '#212121',
    primary: '#5c6bc0',
  },
};

function App() {
  const [isDark, setIsDark] = useState(true);
  const theme = isDark ? darkTheme : lightTheme;

  return (
    <ThemeProvider theme={theme}>
      <AppContainer>
        <button onClick={() => setIsDark(!isDark)}>
          Toggle Theme
        </button>
        <Dashboard />
      </AppContainer>
    </ThemeProvider>
  );
}

Po kliknięciu zmienia się tylko obiekt przekazany do theme, a wszystkie styled-components przeliczają swoje style. Kod komponentów pozostaje nietknięty. To działa jedynie wtedy, gdy oba motywy mają identyczne klucze, bo brakujący klucz oznacza undefined w CSS.

Global Styles

createGlobalStyle pozwala na zdefiniowanie globalnych stylów CSS, które również mają dostęp do motywu. Zwraca komponent, który renderujesz raz, wewnątrz ThemeProvider:

import { createGlobalStyle } from 'styled-components';

const GlobalStyles = createGlobalStyle`
  * {
    margin: 0;
    padding: 0;
    box-sizing: border-box;
  }

  body {
    background: ${({ theme }) => theme.colors.background};
    color: ${({ theme }) => theme.colors.text};
    font-family: 'Segoe UI', sans-serif;
  }
`;

function App() {
  return (
    <ThemeProvider theme={spaceTheme}>
      <GlobalStyles />
      <Dashboard />
    </ThemeProvider>
  );
}

GlobalStyles musi stać wewnątrz providera, inaczej theme byłby pusty. Dzięki temu tło całej strony zmienia się razem z motywem, a nie tylko tło pojedynczych paneli.

Hook useTheme

Jeśli potrzebujesz dostępu do motywu w logice komponentu (nie tylko w stylach), użyj hooka useTheme. Zwraca ten sam obiekt, który przekazałeś do providera:

import { useTheme } from 'styled-components';

function StatusChart({ data }) {
  const theme = useTheme();

  // Użyj kolorów motywu w logice np. do Canvas, SVG, lub warunków
  const chartColor = data.isHealthy
    ? theme.colors.success
    : theme.colors.danger;

  return (
    <div>
      <svg width="100" height="100">
        <circle cx="50" cy="50" r="40" fill={chartColor} />
      </svg>
      <p style={{ color: theme.colors.text }}>
        Status: {data.isHealthy ? 'OK' : 'Alert'}
      </p>
    </div>
  );
}

useTheme jest przydatny, gdy potrzebujesz wartości z motywu poza styled-components - na przykład do rysowania na Canvas, konfigurowania bibliotek wykresów lub warunkowej logiki opartej na kolorach motywu.

Zagnieżdżone motywy

ThemeProvider można zagnieżdżać, aby różne sekcje aplikacji miały różne motywy. Najbliższy provider wygrywa:

function App() {
  return (
    <ThemeProvider theme={darkTheme}>
      <Header />
      <ThemeProvider theme={lightTheme}>
        <ContentArea />  {/* Tu obowiązuje lightTheme */}
      </ThemeProvider>
      <Footer />  {/* Tu wraca darkTheme */}
    </ThemeProvider>
  );
}

To jak różne sekcje statku kosmicznego z różnymi trybami oświetlenia - mostek dowodzenia może być ciemny, a laboratorium jasne. Wewnętrzny provider może też dostać funkcję theme={outer => ({ ...outer, ... })}, która rozszerza motyw zewnętrzny zamiast go zastępować.

Najlepsze praktyki themingu

  1. Centralizuj kolory i rozmiary - nigdy nie hardcoduj wartości w komponentach, zawsze odwołuj się do motywu
  2. Użyj TypeScript - zdefiniuj typ dla motywu, aby mieć autouzupełnianie (w styled-components rozszerzasz interfejs DefaultTheme)
  3. Zachowaj spójność - wszystkie motywy powinny mieć te same klucze (colors, spacing, fontSize)
  4. Testuj oba motywy - upewnij się, że każdy komponent wygląda dobrze zarówno w ciemnym, jak i jasnym trybie

W kolejnej lekcji zobaczysz responsywne wzorce, a w projekcie głównym połączysz ten motyw z CSS Modules i Tailwindem w jednym pulpicie misji.

Pamiętaj: motyw to wspólna paleta floty, zmieniasz ją w jednym miejscu, a każdy statek od razu świeci nowymi barwami.

Kod do tej lekcji: App.jsx
import React, { useState } from 'react';
import styled, { ThemeProvider, createGlobalStyle } from 'styled-components';

// Dwa motywy -- ciemny (kosmiczny) i jasny
const darkTheme = {
  colors: {
    primary: '#7c4dff',
    secondary: '#64b5f6',
    background: '#0a0a2e',
    surface: '#1a1a4e',
    text: '#e0e0e0',
    textMuted: '#9e9e9e',
    border: '#3949ab',
    success: '#00e676',
    warning: '#ffa726',
    danger: '#f44336',
  },
  spacing: { xs: '4px', sm: '8px', md: '16px', lg: '24px', xl: '32px' },
  borderRadius: { sm: '4px', md: '8px', lg: '12px' },
  fontSize: { sm: '12px', md: '16px', lg: '20px', xl: '28px' },
};

const lightTheme = {
  colors: {
    primary: '#5c6bc0',
    secondary: '#1976d2',
    background: '#f5f5f5',
    surface: '#ffffff',
    text: '#212121',
    textMuted: '#757575',
    border: '#e0e0e0',
    success: '#4caf50',
    warning: '#ff9800',
    danger: '#f44336',
  },
  spacing: darkTheme.spacing,
  borderRadius: darkTheme.borderRadius,
  fontSize: darkTheme.fontSize,
};

const GlobalStyles = createGlobalStyle`
  * { margin: 0; padding: 0; box-sizing: border-box; }
  body {
    background: ${({ theme }) => theme.colors.background};
    color: ${({ theme }) => theme.colors.text};
    font-family: 'Segoe UI', sans-serif;
    transition: background 0.3s ease, color 0.3s ease;
  }
`;

const Container = styled.div`
  max-width: 600px;
  margin: 0 auto;
  padding: ${({ theme }) => theme.spacing.lg};
`;

const Header = styled.header`
  display: flex;
  justify-content: space-between;
  align-items: center;
  margin-bottom: ${({ theme }) => theme.spacing.xl};
`;

const Title = styled.h1`
  color: ${({ theme }) => theme.colors.primary};
  font-size: ${({ theme }) => theme.fontSize.xl};
`;

const ThemeToggle = styled.button`
  padding: ${({ theme }) => theme.spacing.sm} ${({ theme }) => theme.spacing.md};
  background: ${({ theme }) => theme.colors.surface};
  color: ${({ theme }) => theme.colors.text};
  border: 2px solid ${({ theme }) => theme.colors.border};
  border-radius: ${({ theme }) => theme.borderRadius.md};
  cursor: pointer;
  font-size: ${({ theme }) => theme.fontSize.md};
  transition: all 0.2s ease;
  &:hover { border-color: ${({ theme }) => theme.colors.primary}; }
`;

const Card = styled.div`
  background: ${({ theme }) => theme.colors.surface};
  border: 1px solid ${({ theme }) => theme.colors.border};
  border-radius: ${({ theme }) => theme.borderRadius.lg};
  padding: ${({ theme }) => theme.spacing.lg};
  margin-bottom: ${({ theme }) => theme.spacing.md};
  transition: all 0.3s ease;
`;

const CardTitle = styled.h3`
  color: ${({ theme }) => theme.colors.primary};
  margin-bottom: ${({ theme }) => theme.spacing.sm};
`;

const Badge = styled.span`
  display: inline-block;
  padding: 2px 10px;
  border-radius: 12px;
  font-size: ${({ theme }) => theme.fontSize.sm};
  font-weight: bold;
  background: ${({ theme, variant }) =>
    variant === 'success' ? theme.colors.success + '33' :
    variant === 'warning' ? theme.colors.warning + '33' :
    theme.colors.danger + '33'};
  color: ${({ theme, variant }) =>
    variant === 'success' ? theme.colors.success :
    variant === 'warning' ? theme.colors.warning :
    theme.colors.danger};
`;

export default function App() {
  const [isDark, setIsDark] = useState(true);

  return (
    <ThemeProvider theme={isDark ? darkTheme : lightTheme}>
      <GlobalStyles />
      <Container>
        <Header>
          <Title>Theme Demo</Title>
          <ThemeToggle onClick={() => setIsDark(!isDark)}>
            {isDark ? 'Light' : 'Dark'}
          </ThemeToggle>
        </Header>

        <Card>
          <CardTitle>Silniki jonowe</CardTitle>
          <p>Status: <Badge variant="success">Aktywne</Badge></p>
          <p style={{ marginTop: '8px', fontSize: '14px' }}>
            Pelna moc -- gotowe do skoku nadprzestrzennego.
          </p>
        </Card>

        <Card>
          <CardTitle>Oslony energetyczne</CardTitle>
          <p>Status: <Badge variant="warning">Ostrzezenie</Badge></p>
          <p style={{ marginTop: '8px', fontSize: '14px' }}>
            Poziom energii: 42%. Wymagane doladowanie.
          </p>
        </Card>

        <Card>
          <CardTitle>System podtrzymania zycia</CardTitle>
          <p>Status: <Badge variant="danger">Krytyczny</Badge></p>
          <p style={{ marginTop: '8px', fontSize: '14px' }}>
            Zapasy tlenu na 72h. Natychmiastowa interwencja!
          </p>
        </Card>
      </Container>
    </ThemeProvider>
  );
}

Hasła z dokumentacji w tej lekcji

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Jaka jest rola komponentu ThemeProvider w styled-components?

  2. 2. Do czego służy createGlobalStyle w styled-components?

Zadania praktyczne w grze

  • Układanie w pionie

    Ułóż kolejność elementów w prawidłowej hierarchii ThemeProvider:

  • Edytor kodu

    Zaimplementuj przełączanie motywów z ThemeProvider

  • Klikanie w kolejności

    Ułóż składnię dostępu do koloru primary z motywu w styled-component:

  • Edytor kodu

    Zaimplementuj nawigację z dynamicznym stylem aktywnego linku

  1. PytanieThemeProvider w styled-components
  2. Ułóż w kolejnościHierarchia ThemeProvider
  3. Zadanie z kodemPraktyka: Przełącznik motywów
  4. PytaniecreateGlobalStyle w styled-components
  5. Kliknij w kolejnościDostęp do motywu w styled-components
  6. Zadanie z kodemPraktyka: Nawigacja styled-components

Przydatne artykuły