Kurs JavaScript i React · Moduł 3: Stan i zdarzenia
Projekt: Marsjański Dashboard Kolonii
W tej lekcji5
Gratulacje - dotarłeś do finałowego projektu modułu "Stan i zdarzenia"! W poprzednich lekcjach poznałeś useState, obsługę zdarzeń, przepływ danych, podnoszenie stanu (lifting state up) i kontrolowane formularze. Teraz połączysz całą tę wiedzę w jedną spójną aplikację.
Twoim zadaniem jest zbudowanie Marsjańskiego Dashboardu Kolonii - interaktywnego panelu zarządzania bazą na Marsie. Ra, twój kosmiczny przewodnik, zebrał wymagania od centrum dowodzenia. Misja: napisać aplikację React, która monitoruje i kontroluje kluczowe systemy kolonii.
Co budujesz
Dashboard składa się z czterech połączonych sekcji:
- Panel systemów kolonii - monitory atmosfery, zasilania, wody i temperatury
- Centrum sterowania - przyciski do ręcznej regulacji parametrów
- Formularz rejestracji astronautów - kontrolowany formularz do dodawania załogi
- Dziennik zdarzeń - log, do którego każdy panel dopisuje wpisy przez funkcję
addLogEntryz props
Wszystkie sekcje muszą ze sobą współpracować - zmiany w jednym panelu wpływają na inne.
Wymagania techniczne
1. Wiele stanów (useState)
Każdy system kolonii ma własny stan:
const [atmosphere, setAtmosphere] = useState(78);
const [power, setPower] = useState(85);
const [water, setWater] = useState(62);
const [temperature, setTemperature] = useState(-10);
const [crew, setCrew] = useState([
{ id: 1, name: 'Anna Kowalska', role: 'Komandor' },
{ id: 2, name: 'Jan Wiśniewski', role: 'Inżynier' }
]);2. Obsługa zdarzeń
Każdy system ma przyciski do regulacji. Pamiętaj o zakresach bezpiecznych:
const handleAtmosphereBoost = () => {
setAtmosphere(prev => Math.min(100, prev + 5));
addLogEntry('Zwiększono poziom O2 o 5%');
};3. Kontrolowany formularz rejestracji
Formularz do dodawania nowych astronautów do załogi:
const [newCrew, setNewCrew] = useState({ name: '', role: '' });
const handleCrewChange = (event) => {
const { name, value } = event.target;
setNewCrew(prev => ({ ...prev, [name]: value }));
};
const handleCrewSubmit = (event) => {
event.preventDefault();
if (!newCrew.name.trim()) return;
setCrew(prev => [...prev, { id: Date.now(), ...newCrew }]);
setNewCrew({ name: '', role: '' });
};4. Alarmy w obsłudze zdarzeń
Stan krytyczny sprawdzaj w handlerze, który zmienia wartość - alarm pojawi się dokładnie w chwili zmiany:
const changePower = (delta) => {
const next = Math.min(100, Math.max(0, power + delta));
setPower(next);
if (next < 20) {
addLogEntry('ALARM: Krytycznie niski poziom zasilania!');
}
};Zmiany w czasie (np. zużycie wody co 5 sekund) wymagają hooka useEffect ze sprzątaniem - poznasz go w module o efektach i wtedy rozbudujesz ten dashboard.
5. Lifting state up - wspólny dziennik zdarzeń
Stan dziennika i funkcja addLogEntry żyją w komponencie głównym i są przekazywane w dół:
function MarsColonyDashboard() {
const [log, setLog] = useState([]);
const addLogEntry = (message) => {
setLog(prev => [
{ id: Date.now(), time: new Date().toLocaleTimeString(), message },
...prev
].slice(0, 20));
};
return (
<div>
<SystemsPanel onLog={addLogEntry} />
<CrewPanel onLog={addLogEntry} />
<EventLog entries={log} />
</div>
);
}Struktura komponentów
Tak może wyglądać drzewo komponentów - stan żyje na górze, a panele dostają go przez props:
MarsColonyDashboard (stan główny)
├── SystemsPanel (props: wartości + callbacki)
│ └── SystemGauge × 4
├── CrewPanel (props: crew, formularz, callbacki)
│ ├── CrewList
│ └── CrewForm
└── EventLog (props: entries)Dane płyną w dół przez props, zdarzenia w górę przez callbacki - serce jednokierunkowego przepływu danych w React!
Kryteria oceny
- useState - minimum 4 stany (atmosfera, zasilanie, woda, temperatura) + stan załogi + stan formularza
- Obsługa zdarzeń - przyciski regulujące parametry z zabezpieczeniami (min/max)
- Kontrolowany formularz - dodawanie nowych astronautów z walidacją
- Alarmy - sprawdzanie stanu krytycznego w handlerach i wpis do dziennika
- Lifting state up - wspólny dziennik zdarzeń dostępny z wielu komponentów
- Komponentyzacja - minimum 3 osobne komponenty komunikujące się przez props
Szkielet startowy
Na start dostajesz szkielet aplikacji zgodny z powyższą strukturą: MarsColonyDashboard trzyma stany i dziennik, a panele dostają dane i funkcje przez props. Przyciski atmosfery i zasilania już działają i dopisują wpisy do dziennika - uzupełnij miejsca oznaczone TODO: stany wody i temperatury, limity 0-100, alarm niskiego zasilania i formularz rejestracji astronautów.
Kod do tej lekcji: App.jsx
import { useState } from 'react';
// Szkielet projektu "Marsjański Dashboard Kolonii" (lekcja 3_7).
// Stany i dziennik żyją w MarsColonyDashboard, a panele dostają dane i funkcje przez props.
// Uzupełnij miejsca oznaczone TODO.
let nextLogId = 1;
function SystemGauge({ label, value, unit, onAdjust }) {
return (
<div style={styles.gauge}>
<h3 style={styles.gaugeLabel}>{label}</h3>
<p style={styles.gaugeValue}>{value}{unit}</p>
<button style={styles.button} onClick={() => onAdjust(-5)}>-5</button>
<button style={styles.button} onClick={() => onAdjust(5)}>+5</button>
</div>
);
}
function SystemsPanel({ atmosphere, power, onAtmosphereChange, onPowerChange }) {
return (
<section style={styles.panel}>
<h2 style={styles.title}>Systemy kolonii</h2>
<div style={styles.gauges}>
<SystemGauge label="Atmosfera (O2)" value={atmosphere} unit="%" onAdjust={onAtmosphereChange} />
<SystemGauge label="Zasilanie" value={power} unit="%" onAdjust={onPowerChange} />
{/* TODO: wskaźniki wody (%) i temperatury (°C) */}
</div>
</section>
);
}
function CrewPanel({ crew }) {
// TODO: kontrolowany formularz { name, role } z e.preventDefault() i walidacją.
// Nowego astronautę dodaje funkcja z props, bo stan załogi żyje w rodzicu.
return (
<section style={styles.panel}>
<h2 style={styles.title}>Załoga ({crew.length})</h2>
<ul style={styles.list}>
{crew.map((member) => (
<li key={member.id}>{member.name} - {member.role}</li>
))}
</ul>
</section>
);
}
function EventLog({ entries }) {
return (
<section style={styles.panel}>
<h2 style={styles.title}>Dziennik zdarzeń</h2>
{entries.length === 0 ? (
<p style={styles.muted}>Brak wpisów - użyj przycisków w panelu systemów.</p>
) : (
<ul style={styles.list}>
{entries.map((entry) => (
<li key={entry.id}>[{entry.time}] {entry.message}</li>
))}
</ul>
)}
</section>
);
}
function MarsColonyDashboard() {
const [atmosphere, setAtmosphere] = useState(78);
const [power, setPower] = useState(85);
// TODO: stany water (62) i temperature (-10)
const [crew, setCrew] = useState([
{ id: 1, name: 'Anna Kowalska', role: 'Komandor' },
{ id: 2, name: 'Jan Wiśniewski', role: 'Inżynier' },
]);
const [log, setLog] = useState([]);
// Wspólny dziennik: panele dopisują wpisy przez tę funkcję przekazaną w props
const addLogEntry = (message) => {
const entry = { id: nextLogId++, time: new Date().toLocaleTimeString(), message };
setLog((prev) => [entry, ...prev].slice(0, 20));
};
const changeAtmosphere = (delta) => {
// TODO: pilnuj zakresu 0-100 (Math.min i Math.max)
setAtmosphere(atmosphere + delta);
addLogEntry('Atmosfera: ' + (delta > 0 ? '+' : '') + delta + '%');
};
const changePower = (delta) => {
// TODO: zakres 0-100 i alarm w dzienniku, gdy zasilanie spadnie poniżej 20%
setPower(power + delta);
addLogEntry('Zasilanie: ' + (delta > 0 ? '+' : '') + delta + '%');
};
// TODO: funkcja addCrewMember(member), która przez setCrew doda astronautę
// i dopisze wpis do dziennika; przekaż ją do CrewPanel
return (
<div style={styles.app}>
<h1 style={styles.header}>Marsjański Dashboard Kolonii</h1>
<SystemsPanel
atmosphere={atmosphere}
power={power}
onAtmosphereChange={changeAtmosphere}
onPowerChange={changePower}
/>
<CrewPanel crew={crew} />
<EventLog entries={log} />
</div>
);
}
const styles = {
app: { fontFamily: 'Arial, sans-serif', background: '#0b1020', color: '#e6ecff', minHeight: '100vh', padding: '20px' },
header: { color: '#ff8c42', textAlign: 'center', marginTop: 0 },
panel: { background: '#151c33', borderRadius: '12px', padding: '16px', marginBottom: '16px' },
title: { marginTop: 0, color: '#7fd1ff' },
gauges: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(160px, 1fr))', gap: '12px' },
gauge: { background: '#1e2747', borderRadius: '10px', padding: '12px', textAlign: 'center' },
gaugeLabel: { margin: '0 0 6px', fontSize: '15px' },
gaugeValue: { margin: '0 0 10px', fontSize: '28px', fontWeight: 'bold' },
button: { margin: '0 4px', padding: '6px 12px', border: 'none', borderRadius: '6px', background: '#3a4f9a', color: 'white', cursor: 'pointer' },
list: { margin: 0, paddingLeft: '20px', lineHeight: 1.7 },
muted: { color: '#8f9bbf', margin: 0 },
};
export default function App() {
return <MarsColonyDashboard />;
}Powodzenia, pilocie! Ten projekt to twoja pierwsza prawdziwa misja w świecie React - pokaż, że potrafisz zarządzać kolonią na Marsie. Pamiętaj: każdy panel to osobny moduł statku, ale dane i decyzje płyną przez jednego dowódcę - komponent główny.
Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?