Kurs JavaScript i React · Moduł 14: Zaawansowane stylowanie

CSS Modules - Izolowane Panele Sterowania

4 min czytania ·
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. 1. Jaka jest prawidłowa składnia odwołania do CSS Variable w arkuszu stylów?

  2. 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

  1. PytanieSkładnia CSS Variables
  2. Zadanie z kodemPraktyka: CSS Modules - AlertBox
  3. PytanieIzolacja CSS Modules
  4. Kliknij w kolejnościImport CSS Module
  5. Zadanie z kodemPraktyka: CSS Modules - Zakładki

Przydatne artykuły