Kurs JavaScript i React · Moduł 6: React Router
Przekierowania w kosmicznej nawigacji
W tej lekcji8
Wyobraź sobie że stacja kosmiczna zmieniła adres: dawna ścieżka /old-station prowadzi donikąd, a załoga wciąż ma ją w zakładkach. Albo niezalogowany turysta próbuje wejść do centrum dowodzenia. W obu przypadkach nie chcemy pokazywać pustej strony ani błędu. Chcemy, żeby statek sam zmienił kurs.
W przestrzeni międzygwiezdnej czasami musimy natychmiast przekierować nasz statek na inną trasę. W świecie React Router, przekierowania działają podobnie - pozwalają nam przenieść użytkownika z jednej ścieżki na drugą automatycznie.
Przykłady w tej lekcji działają tak samo w React Router v6 i v7. W v7 te same komponenty i hooki możesz importować z pakietu react-router, a react-router-dom nadal je udostępnia, więc importy z tej lekcji pozostają poprawne. W wersji v8, wydanej w czerwcu 2026, pakietu react-router-dom już nie ma: te same komponenty i hooki importujesz wtedy z react-router, a sam kod przykładów się nie zmienia.
Komponent Navigate
Najprostszym sposobem na utworzenie przekierowania jest użycie komponentu Navigate z React Router:
import { Navigate } from 'react-router-dom';
function RedirectToControl() {
return <Navigate to="/control-center" />;
}Gdy ten komponent jest renderowany, użytkownik zostanie automatycznie przekierowany na wskazaną ścieżkę. Jest to deklaratywny sposób na przekierowanie - po prostu umieszczasz komponent w drzewie JSX.
Przekierowanie starej trasy
Najprostszy scenariusz to trasa, która zmieniła adres. Konfiguracja przebiega w czterech krokach: definiujesz trasę źródłową, jako jej element podajesz Navigate z nowym adresem, dodajesz replace, a React Router sam przenosi użytkownika:
<Routes>
<Route path="/old-station" element={<Navigate to="/space-station" replace />} />
<Route path="/space-station" element={<SpaceStation />} />
</Routes>Kto wpisze stary adres, trafi na /space-station, a w historii przeglądarki nie zostanie ślad po starej ścieżce. Komponent SpaceStation nie wie nic o przekierowaniu i nie wymaga żadnych zmian.
Przekierowania warunkowe
Często potrzebujemy przekierować użytkownika tylko w określonych warunkach, na przykład gdy nie jest zalogowany. Hook useAuth w przykładach to nasz własny hook (nie część React Router), który zwraca informacje o zalogowanym użytkowniku:
function SecretMoonBase() {
const isAstronaut = useAuth();
if (!isAstronaut) {
return <Navigate to="/access-denied" replace />;
}
return (
<div>
<h1>Tajna baza księżycowa</h1>
<p>Witaj astronauto! Masz dostęp do tajnych danych.</p>
</div>
);
}Atrybut replace sprawia, że przekierowanie zastępuje bieżącą stronę w historii przeglądarki, zamiast dodawać nową. Dzięki temu użytkownik nie trafi z powrotem na chronioną stronę po kliknięciu przycisku "wstecz".
Przekierowania programowe
Czasami potrzebujemy przekierować użytkownika w odpowiedzi na jakieś zdarzenie, jak przesłanie formularza. Używamy wtedy hooka useNavigate:
import { useNavigate } from 'react-router-dom';
function LaunchControlForm() {
const navigate = useNavigate();
const handleLaunch = (event) => {
event.preventDefault();
// Logika przygotowania startu...
// Przekierowanie do strony odliczania
navigate('/countdown');
// Lub z parametrem replace
// navigate('/countdown', { replace: true });
};
return (
<form onSubmit={handleLaunch}>
<h2>Panel kontroli startu</h2>
<button type="submit">Rozpocznij odliczanie</button>
</form>
);
}Funkcję navigate wywołujemy w obsłudze zdarzenia, a nie bezpośrednio w ciele komponentu. React Router ostrzega, jeśli wywołasz ją w trakcie pierwszego renderowania. Tam, gdzie decyzja zapada podczas renderowania, lepiej pasuje komponent Navigate.
Te dwa narzędzia to końce jednej skali. Od najbardziej deklaratywnego do imperatywnego: Link (zwykły odnośnik w JSX), NavLink (odnośnik ze stanem aktywnym), Navigate (przekierowanie w JSX) i useNavigate (hook wywoływany w kodzie).
Obsługa nieistniejących ścieżek (404)
React Router pozwala nam łatwo obsłużyć przypadek, gdy użytkownik próbuje odwiedzić ścieżkę, która nie istnieje:
<Routes>
<Route path="/mission-control" element={<MissionControl />} />
<Route path="/navigation" element={<Navigation />} />
<Route path="*" element={<Navigate to="/lost-in-space" />} />
</Routes>Ścieżka * dopasowuje się do każdej trasy, która nie pasuje do żadnej z poprzednich. Zamiast Navigate możemy również wyrenderować komponent 404:
<Route path="*" element={<LostInSpace />} />Polecam drugi wariant. Strona "zagubiony w kosmosie" zostawia w pasku adresu błędny URL, więc użytkownik widzi, co wpisał, i może to poprawić.
Przekierowania z parametrami
Możemy również przekazać dodatkowe dane podczas przekierowania. Służy do tego opcja state, dostępna zarówno w komponencie, jak i w funkcji navigate:
// Przekierowanie deklaratywne z parametrami
<Navigate
to="/asteroid-alert"
state={{ severity: "high", location: "sector-7" }}
/>
// Przekierowanie programowe z parametrami
navigate('/asteroid-alert', {
state: { severity: "high", location: "sector-7" }
});Dane ze state nie trafiają do adresu URL, więc adres pozostaje czysty. W komponencie docelowym możemy odczytać te dane za pomocą hooka useLocation:
import { useLocation } from 'react-router-dom';
function AsteroidAlert() {
const location = useLocation();
const { severity, location: asteroidLocation } = location.state || {};
return (
<div className="alert">
<h1>Ostrzeżenie o asteroidzie!</h1>
{severity && asteroidLocation && (
<p>
Wykryto asteroidę o zagrożeniu {severity} w lokalizacji {asteroidLocation}.
</p>
)}
</div>
);
}Zwróć uwagę na location.state || {}. Jeśli ktoś wejdzie na stronę bezpośrednio z paska adresu, state będzie puste, a zabezpieczenie chroni komponent przed błędem.
Przekierowania z uwierzytelnianiem
Najczęstszym przypadkiem użycia przekierowań jest ochrona tras przed nieuprawnionymi użytkownikami. Komponent ProtectedRoute odczytuje bieżącą lokalizację hookiem useLocation, żeby zapamiętać, dokąd użytkownik chciał lecieć:
function ProtectedRoute({ children }) {
const { user, loading } = useAuth();
const location = useLocation();
if (loading) {
return <LoadingSpinner />;
}
if (!user) {
// Przekierowanie do strony logowania z zapisaniem oryginalnej ścieżki
return <Navigate to="/login" state={{ from: location.pathname }} />;
}
return children;
}
// Użycie:
<Routes>
<Route path="/mission-control" element={
<ProtectedRoute>
<MissionControl />
</ProtectedRoute>
} />
</Routes>Chroniony komponent MissionControl pozostaje niezmieniony, całą logikę dostępu trzyma opakowanie. Na stronie logowania możemy odczytać oryginalną ścieżkę i przekierować z powrotem po zalogowaniu:
function Login() {
const navigate = useNavigate();
const location = useLocation();
const from = location.state?.from || '/dashboard';
const handleLogin = async (credentials) => {
const success = await loginUser(credentials);
if (success) {
// Przekierowanie z powrotem do oryginalnej strony
navigate(from, { replace: true });
}
};
// Reszta komponentu...
}Tutaj replace: true usuwa stronę logowania z historii, więc przycisk "wstecz" nie cofnie zalogowanego astronauty do formularza.
W trybie danych React Router (od v6.4, także w v7) przekierowania wykonuje się często już w funkcjach loader i action za pomocą funkcji redirect, zanim komponent w ogóle się wyrenderuje. Poznasz to przy bardziej zaawansowanej architekturze routingu.
Podsumowanie
Przekierowania są potężnym narzędziem w aplikacjach React wykorzystujących React Router. Pozwalają na:
- Automatyczne przenoszenie użytkowników między ścieżkami
- Tworzenie chronionych stref wymagających uwierzytelnienia
- Obsługę nieistniejących ścieżek (404)
- Przekazywanie danych między stronami podczas przekierowania
Pamiętaj, aby używać parametru replace gdy chcesz zapobiec powrotowi użytkownika do poprzedniej strony za pomocą przycisku "wstecz" - jest to szczególnie ważne w przypadku stron logowania i innych scenariuszy uwierzytelniania.
Z zabezpieczaniem ścieżek zetknąłeś się już w poprzedniej lekcji, a w następnej zobaczysz, jak lazy loading ładuje moduły statku dopiero wtedy, gdy są potrzebne.
Zapamiętaj: Navigate zmienia kurs podczas renderowania, useNavigate po zdarzeniu, a replace sprząta ślady w dzienniku lotu.
Kod do tej lekcji: App.jsx
import React from 'react';
import { BrowserRouter, Routes, Route, Link, Outlet, useParams } from 'react-router-dom';
// Layout dla sekcji Fleet
function FleetLayout() {
return (
<div className="fleet-layout">
<aside className="fleet-nav">
<h2>Flota</h2>
<Link to="/fleet/alpha">Alpha Squadron</Link>
<Link to="/fleet/beta">Beta Squadron</Link>
<Link to="/fleet/gamma">Gamma Squadron</Link>
</aside>
<main className="fleet-content">
{/* Outlet renderuje zagnieżdżone trasy */}
<Outlet />
</main>
</div>
);
}
// Strona główna floty
function FleetHome() {
return (
<div className="page">
<h1>Wybierz eskadron</h1>
<p>Kliknij na eskadron w menu, aby zobaczyć szczegóły.</p>
</div>
);
}
// Szczegóły eskadronu
function SquadronDetails() {
const { squadronId } = useParams();
return (
<div className="page squadron">
<h1>Eskadron: {squadronId?.toUpperCase()}</h1>
<div className="squadron-nav">
<Link to={`/fleet/${squadronId}/ships`}>Statki</Link>
<Link to={`/fleet/${squadronId}/crew`}>Załoga</Link>
<Link to={`/fleet/${squadronId}/missions`}>Misje</Link>
</div>
{/* Kolejny Outlet dla głębiej zagnieżdżonych tras */}
<Outlet />
</div>
);
}
// Komponenty zagnieżdżone dla eskadronu
function SquadronShips() {
const { squadronId } = useParams();
return (
<div className="sub-page">
<h2>Statki eskadronu {squadronId}</h2>
<ul>
<li>Fighter-01</li>
<li>Fighter-02</li>
<li>Cruiser-01</li>
</ul>
</div>
);
}
function SquadronCrew() {
const { squadronId } = useParams();
return (
<div className="sub-page">
<h2>Załoga eskadronu {squadronId}</h2>
<ul>
<li>Kapitan: John Smith</li>
<li>Pilot: Anna Kowalska</li>
<li>Inżynier: Mark Johnson</li>
</ul>
</div>
);
}
function SquadronMissions() {
const { squadronId } = useParams();
return (
<div className="sub-page">
<h2>Misje eskadronu {squadronId}</h2>
<ul>
<li>Patrol sektora 7 - W trakcie</li>
<li>Eskort transportowca - Zakończona</li>
</ul>
</div>
);
}
function App() {
return (
<BrowserRouter>
<div className="app">
<header>
<Link to="/">Home</Link>
<Link to="/fleet">Flota</Link>
</header>
<Routes>
<Route path="/" element={<div className="page home"><h1>Space Command</h1></div>} />
{/* Zagnieżdżone trasy */}
<Route path="/fleet" element={<FleetLayout />}>
<Route index element={<FleetHome />} />
<Route path=":squadronId" element={<SquadronDetails />}>
<Route path="ships" element={<SquadronShips />} />
<Route path="crew" element={<SquadronCrew />} />
<Route path="missions" element={<SquadronMissions />} />
</Route>
</Route>
</Routes>
</div>
</BrowserRouter>
);
}
export default App;Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Zadania praktyczne w grze
- Układanie w pionie
Uporządkuj kroki konfiguracji przekierowania (redirect) w React Router v6:
- Układanie w pionie
Uporządkuj proces renderowania zagnieżdżonej trasy w React Router:
- Edytor kodu
Dynamic data loading z params
- Klikanie w kolejności
Ułóż kod programowej nawigacji po logowaniu:
- Układanie w pionie
Ułóż sposoby nawigacji React Router od deklaratywnego do imperatywnego: