Kurs JavaScript i React · Moduł 14: Zaawansowane stylowanie
CSS Modules - Izolowane Panele Sterowania
W tej lekcji8
CSS Modules to jeden z najpopularniejszych sposobów stylowania w React. Działa jak system izolowanych paneli sterowania na statku kosmicznym -- każdy moduł ma swoje własne kontrolki, które nie kolidują z innymi.
Czym są CSS Modules?
CSS Modules to zwykłe pliki CSS z rozszerzeniem .module.css. Różnica polega na tym, że wszystkie nazwy klas są automatycznie unikalne -- React generuje unikalne identyfikatory, dzięki czemu style z jednego komponentu nigdy nie nadpiszą stylów innego.
/* SpacePanel.module.css */
.panel {
background: #0d1137;
border: 2px solid #3949ab;
border-radius: 12px;
padding: 20px;
}
.title {
color: #7c4dff;
font-size: 24px;
margin-bottom: 16px;
}
.statusActive {
color: #00e676;
font-weight: bold;
}Importowanie i używanie
Importujemy CSS Module jako obiekt i odwołujemy się do klas jak do właściwości obiektu:
import styles from './SpacePanel.module.css';
function SpacePanel({ title, status }) {
return (
<div className={styles.panel}>
<h2 className={styles.title}>{title}</h2>
<span className={styles.statusActive}>
Status: {status}
</span>
</div>
);
}W wygenerowanym HTML klasa panel stanie się czymś w stylu SpacePanel_panel_x7k2f -- całkowicie unikalna!
Łączenie klas
Często potrzebujemy łączyć kilka klas CSS. W CSS Modules możemy to robić na kilka sposobów:
// Template literal
<div className={`${styles.panel} ${styles.dark}`}>
// Z warunkiem
<div className={`${styles.panel} ${isActive ? styles.active : ''}`}>
// Tablica z join
<div className={[styles.panel, styles.dark].join(' ')}>Compose -- dziedziczenie stylów
CSS Modules oferują specjalną dyrektywę composes, która pozwala dziedziczyć style z innych klas:
/* base.module.css */
.baseButton {
padding: 10px 20px;
border: none;
border-radius: 6px;
cursor: pointer;
font-size: 14px;
transition: all 0.3s ease;
}
/* SpaceButton.module.css */
.primaryButton {
composes: baseButton from './base.module.css';
background: #7c4dff;
color: white;
}
.dangerButton {
composes: baseButton from './base.module.css';
background: #f44336;
color: white;
}Dzięki composes unikamy duplikowania stylów, zachowując jednocześnie izolację.
Globalne style w CSS Modules
Jeżeli potrzebujesz klasy globalnej (np. dla zewnętrznych bibliotek), użyj :global:
/* Layout.module.css */
:global(.container) {
max-width: 1200px;
margin: 0 auto;
}
.localClass {
/* To jest lokalne */
color: #64b5f6;
}Dynamiczne klasy z CSS Modules
Często potrzebujemy zmieniać style na podstawie propsów lub stanu. Oto kilka wzorców:
import styles from './Alert.module.css';
function Alert({ type = 'info', message }) {
// Dynamiczne wybieranie klasy na podstawie propsa
const alertClass = styles[type]; // styles.info, styles.warning, styles.error
return (
<div className={`${styles.alert} ${alertClass}`}>
<p className={styles.message}>{message}</p>
</div>
);
}/* Alert.module.css */
.alert {
padding: 16px;
border-radius: 8px;
border-left: 4px solid;
}
.info {
background: #1a237e;
border-color: #64b5f6;
color: #90caf9;
}
.warning {
background: #4a3800;
border-color: #ffa726;
color: #ffcc80;
}
.error {
background: #4a0000;
border-color: #f44336;
color: #ef9a9a;
}Zwróć uwagę, że styles[type] pozwala dynamicznie wybierać klasę na podstawie zmiennej -- to jak przełączanie trybów na panelu sterowania.
Biblioteka classnames / clsx
Do bardziej złożonych kombinacji klas warto używać biblioteki clsx lub classnames:
import clsx from 'clsx';
import styles from './Button.module.css';
function SpaceButton({ variant, size, disabled }) {
return (
<button className={clsx(
styles.button,
styles[variant], // styles.primary lub styles.secondary
styles[size], // styles.small lub styles.large
{ [styles.disabled]: disabled } // warunkowo
)}>
Engage!
</button>
);
}Zalety CSS Modules
- Izolacja stylów -- brak konfliktów nazw klas, każdy komponent ma swoją "kapsułę"
- Zwykły CSS -- nie trzeba się uczyć nowej składni, używasz tego samego CSS co zawsze
- Wsparcie natywne w Create React App i Next.js -- zero konfiguracji
- Lekkość -- brak dodatkowych bibliotek w bundlu, zero runtime JS
- Łatwa migracja z istniejącego CSS -- wystarczy zmienić rozszerzenie pliku i import
- Typowanie -- można generować typy TypeScript dla klas CSS (np. przez
typed-css-modules)
CSS Modules to solidny, sprawdzony wybór do stylowania komponentów React. Są jak niezawodne panele sterowania na statku -- proste, przewidywalne i bezkonfliktowe.
Kod do tej lekcji: App.jsx
import React from 'react';
import styles from './SpacePanel.module.css';
function StatusIndicator({ label, status }) {
const statusClass = status === 'active'
? styles.statusActive
: status === 'warning'
? styles.statusWarning
: styles.statusCritical;
return (
<div className={styles.statusRow}>
<span className={styles.label}>{label}</span>
<span className={statusClass}>{status.toUpperCase()}</span>
</div>
);
}
function SpacePanel({ title, children }) {
return (
<div className={styles.panel}>
<h2 className={styles.title}>{title}</h2>
{children}
</div>
);
}
export default function App() {
return (
<div className={styles.app}>
<h1 className={styles.heading}>CSS Modules w React</h1>
<p className={styles.subtitle}>Izolowane style -- kazdy komponent ma swoje unikalne klasy</p>
<SpacePanel title="System nawigacyjny">
<StatusIndicator label="Silnik glowny" status="active" />
<StatusIndicator label="Oslona termiczna" status="warning" />
<StatusIndicator label="Paliwo zapasowe" status="critical" />
</SpacePanel>
<SpacePanel title="Komunikacja">
<StatusIndicator label="Lacze radiowe" status="active" />
<StatusIndicator label="Antena zapasowa" status="active" />
<StatusIndicator label="Sygnal SOS" status="active" />
</SpacePanel>
</div>
);
}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 prawidłowa składnia odwołania do CSS Variable w arkuszu stylów?
2. Co jest główną zaletą CSS Modules w porównaniu ze zwykłymi plikami CSS?
Zadania praktyczne w grze
- Edytor kodu
Zaimplementuj komponent AlertBox z CSS Modules
- Klikanie w kolejności
Ułóż składnię importu CSS Module w React:
- Edytor kodu
Zaimplementuj komponent zakładek z CSS Modules i useState