Kurs JavaScript i React · Moduł 14: Zaawansowane stylowanie
Theming w Styled-components - Galaktyczny System Designu
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
- Centralizuj kolory i rozmiary - nigdy nie hardcoduj wartości w komponentach, zawsze odwołuj się do motywu
- Użyj TypeScript - zdefiniuj typ dla motywu, aby mieć autouzupełnianie (w styled-components rozszerzasz interfejs
DefaultTheme) - Zachowaj spójność - wszystkie motywy powinny mieć te same klucze (colors, spacing, fontSize)
- 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. Jaka jest rola komponentu ThemeProvider w styled-components?
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