React Router voorbeelden (v7)
React Router voorbeelden (v7): routes, loaders, auth, 404 | We.Inc
Kopieerbare React Router 7 voorbeelden: setup in elke modus, geneste layouts, params, loaders en actions, beveiligde routes, 404-pagina's, lazy routes en overstappen van v6.
React Router voorbeelden (v7)
React Router 7 wordt geleverd als één package, react-router. Wikkel uw app in BrowserRouter voor eenvoudige routing, of bouw routes met createBrowserRouter en RouterProvider om loaders, actions en error boundaries te gebruiken. Nest child routes onder een layout die Outlet rendert, lees padsegmenten met useParams en querystrings met useSearchParams.
De API's die u het meest gebruikt
- Behoefte
- Gebruik
- Routes opzetten
- createBrowserRouter + RouterProvider
- Gedeelde layout
- Parent route + <Outlet />
- useParams()
- ?sort=price
- useSearchParams()
- Data laden
- loader + useLoaderData()
- Onbekende URL's
- path: "*"
Elk voorbeeld hieronder is geschreven voor React Router 7 en importeert uit react-router. De kleine demo bovenaan is live, dus u kunt door geneste routes en params klikken; hij draait op de routerversie die deze site gebruikt, en die staat erbij vermeld.
- Kies een modus: declaratief voor eenvoudige sites, data mode voor loaders en actions, framework mode voor een volledige app met server rendering.
- Installeer react-router en zet de router op met het bijpassende voorbeeld.
- Voeg layouts toe met child routes en een Outlet, en daarna dynamische segmenten voor detailpagina's.
- Verplaats het ophalen van data naar loaders en het verzenden van formulieren naar actions, en voeg een error boundary toe aan de root route.
- Sluit af met een *-route voor onbekende URL's en ScrollRestoration in de root layout.
- Gooi redirect() vanuit een loader voor auth-controles; de beveiligde pagina rendert dan nooit voor uitgelogde gebruikers.
- Gebruik NavLink met de end-prop op indexlinks, zodat Overzicht niet op elke child-pagina oplicht.
- Bewaar filters en tabs in search params in plaats van in state, zodat een refresh of gedeelde link ze behoudt.
- Zet minstens een error boundary op de root route; een route zonder geeft fouten door aan zijn parent.
- Stuur op een statische host elk onbekend pad naar index.html, zodat deep links na een refresh werken.
Veelgestelde vragen
Is react-router-dom in v7 nog nodig?
Nee. In v7 wordt alles geëxporteerd vanuit react-router. react-router-dom installeert nog steeds en exporteert dezelfde API opnieuw om upgrades te vergemakkelijken, maar nieuwe projecten hebben alleen react-router nodig.
Wat is het verschil tussen data mode en framework mode?
Data mode is een library: u bouwt de route-array zelf met createBrowserRouter. Framework mode voegt een Vite-plugin toe die app/routes.ts leest, code per route splitst, types genereert en op de server kan renderen.
Hoe maak ik een 404-pagina in React Router?
Voeg een route met path "*" toe als laatste child van uw root route. Die matcht elke URL die verder nergens op matchte. Laat op een statische host de server ook index.html teruggeven voor onbekende paden, zodat de router de kans krijgt hem te tonen.
Geeft useParams getallen terug?
Nee, params zijn altijd strings, of undefined als het segment optioneel is en ontbreekt. Zet ze om met Number() en vang het geval af waarin het resultaat geen geldig getal is.
Kan ik v6-code werkend houden in v7?
Grotendeels wel. Zet eerst in v6 alle zes v7 future flags aan en los de waarschuwingen op, en upgrade daarna. Volgens de officiële gids zijn er daarna geen breaking changes meer, afgezien van de hernoemde package.
Hoe matching werkt
- React Router rangschikt routes op hoe specifiek ze zijn en niet op hun volgorde, dus /projects/new wint van /projects/:projectId, ongeacht welke u eerst opsomt. Een *-route wint alleen als niets specifiekers matcht.
- Child-paden zijn relatief ten opzichte van hun parent. Onder een /dashboard-route matcht een child met path settings op /dashboard/settings, en een index route matcht op /dashboard zelf.
Veelgemaakte fouten
- Na een upgrade imports uit react-router-dom en react-router door elkaar gebruiken, waardoor twee kopieën kunnen laden en de context breekt.
- De Outlet in een layout vergeten, zodat child routes wel matchen maar er niets verschijnt.
- ScrollRestoration of useLoaderData gebruiken met een gewone BrowserRouter; beide hebben een data router nodig.
- Data ophalen in useEffect terwijl een loader het verzoek al zou starten voordat de component rendert.
v7 opzetten
De drie manieren om React Router 7 te gebruiken
- Modus
- Setup
- Wat u krijgt
- Declaratief
- <BrowserRouter> + <Routes>
- Matching, links, params. Geen loaders.
- Data
- createBrowserRouter + <RouterProvider>
- Loaders, actions, Form, error boundaries, lazy, scrollherstel
- Framework
- app/routes.ts + @react-router/dev Vite plugin
- Alles uit data mode plus code splitting op basis van bestanden, typegeneratie en server rendering
Installeren
In v7 dekt één package webapps af. react-router-dom bestaat alleen nog als re-export voor oudere imports.
Data mode: createBrowserRouter + RouterProvider
Routes zijn een gewone array, wat loaders, actions, pending UI en errorElement mogelijk maakt. Alles wordt geïmporteerd uit react-router.
Declaratieve modus: <BrowserRouter>
De kleinste setup en het dichtst bij v6-code. Er zijn geen loaders of actions; haal data in plaats daarvan op binnen componenten.
Framework mode: app/routes.ts
De Vite-plugin uit @react-router/dev leest dit bestand, splitst code per route en genereert types in ./+types/ voor elke routemodule.
Framework mode: een getypeerde routemodule
Elk routebestand exporteert zijn loader en een default component. De gegenereerde Route-types geven params en loaderData echte types.
Geneste routes, params en search params
Geneste routes en een layout met <Outlet>
De parent rendert gedeelde UI één keer; <Outlet /> geeft aan waar de matchende child verschijnt. Een route zonder path, zoals die hieronder, is een layout route.
URL-params met useParams
Een segment dat met een dubbele punt begint, wordt een param. Params zijn altijd strings, dus zet getallen zelf om.
Search params met useSearchParams
Werkt als useState, maar slaat de waarde op in de querystring, zodat filters een refresh overleven en als link gedeeld kunnen worden.
Loaders, actions, auth, fouten, lazy loading en scrollen
Loaders, actions, <Form> en redirect
De loader draait voordat de route rendert. Het verzenden van <Form method="post"> roept de action aan, en als die klaar is laadt de router de loaders op de pagina opnieuw. Geef gewone objecten terug; json() en defer() zijn deprecated in v7.
Beveiligde routes met een redirect
Controleer de sessie in een parent loader en redirect voordat er een child rendert. Geef het oorspronkelijke pad mee zodat u mensen na het inloggen kunt terugsturen.
Beveiligde routes in declaratieve modus
Zonder loaders controleert een wrappercomponent de auth en rendert <Navigate> in plaats van de pagina.
404-catch-all en error boundaries
Een path van * vangt elke URL op die verder nergens op matchte. errorElement (of ErrorBoundary als component) rendert wanneer een loader, action of render een fout gooit; useRouteError vertelt u wat er gegooid is.
Lazy routes
lazy laadt de code van een route de eerste keer dat iemand die bezoekt. Geef de route-eigenschappen terug die u wilt invullen, zoals Component en loader.
Scrollherstel
Render <ScrollRestoration /> één keer in de root layout van een data router. Het scrolt naar boven op nieuwe pagina's en herstelt de oude positie bij terug en vooruit.
Overstappen van v6
Met elke future flag aan in v6 zou de overstap naar v7 geen andere codewijzigingen moeten vragen. Zet elke flag apart live, zodat een probleem makkelijk te herleiden is. Versie 8 is inmiddels ook uit; die upgrade werkt op dezelfde manier, met een nieuwe set v8_-flags die u aanzet terwijl u nog op 7 zit.
Van v6 naar v7
- Stap
- Wat u doet
- Minimale versies
- Node 20, React 18 en React DOM 18
- Eerst v6 bijwerken
- Installeer de nieuwste 6.x zodat de waarschuwingen over future flags verschijnen
- Future flags aanzetten
- v7_relativeSplatPath, v7_startTransition, v7_fetcherPersist, v7_normalizeFormMethod, v7_partialHydration, v7_skipActionErrorRevalidation
- formMethod in hoofdletters vergelijken
- useNavigation().formMethod is nu "POST", niet "post"
- json() en defer() laten vallen
- Geef gewone objecten terug uit loaders, of Response.json() als u een echte response nodig hebt
- De package vervangen
- npm uninstall react-router-dom, npm install react-router, en verander daarna imports in "react-router"
- Imports alleen voor de DOM
- RouterProvider kan ook uit "react-router/dom" komen
Een router op de pagina die react-router-dom 6.30 draait (de versie die deze site levert, niet v7). Er is een /shop-layout met een productlijst en /shop/:productId-detailpagina's, een ?sort-search param en een catch-all 404. De routecode is in v7 hetzelfde.
- Bureaulamp
- Bureaustoel
- Wandplank
Demo
Home
Winkel
Kapotte link
URL:
Winkellayout
Sorteren (search param)
Naam
Prijs
Geen product met de naam "{id}".
useParams() gaf productId =
Terug naar de lijst
Live demo: geneste routes en params
Homepagina. Open de winkel.
404: de catch-all route matchte.
Start gratis proefperiode · 7 dagen gratis, vandaag $0
Gerelateerd: Gidsen
- React Server Components uitgelegd
- React data table voorbeelden met TanStack Table
- React met TypeScript
- React UI-bibliotheken vergeleken
- React vs React Native
- Regex-spiekbriefje
- Een URL uit Google Zoeken verwijderen
- robots.txt Disallow all
Product
Voor wie
- Voor bureaus
- Voor freelancers
- Voor hostingproviders
- Voor SaaS-platforms
- Voor startups
- Financiële diensten
- Zorgoplossingen
Functies
Bronnen
- Blog
- Helpcentrum
- Gratis bedrijfstools
- Free UI Components
- Sjablonen
- Sjablooncollecties
- Websitevoorbeelden
- Gidsen
- Vergelijkingen
- Alternatieven
- De beste
- Reviews
- Prijsgidsen
- Toepassingen
- Woordenlijst en handleidingen
- Integraties
- Ontwikkelaars
- Benchmark
- Windows App