Trasy dynamiczne i segmenty catch-all
Twórz elastyczne trasy dopasowujące się do dynamicznej zawartości za pomocą segmentów dynamicznych i tras catch-all.
Trasy dynamiczne i segmenty catch-all to bezpłatna lekcja Next.js 15 Fullstack Web Apps na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Next.js 15 Fullstack Web Apps, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Next.js 15 Fullstack Web Apps zawiera 4 lekcji w sumie.
Części tej lekcji nie zostały jeszcze przetłumaczone i są wyświetlane po angielsku.
Flexible Routing in Next.js
Welcome to dynamic routing in Next.js! Modern web applications often need flexible URLs for content like blog posts, product details, or user profiles.
Instead of creating a separate page for each item, dynamic routes let you use a single page template to handle many different URLs based on their path.
Creating Dynamic Segments
In Next.js, you create a dynamic route by enclosing a folder name in square brackets, like [slug].
This [slug] segment acts as a placeholder. Whatever value is in that part of the URL will be captured and made available to your page component.
- Example:
app/blog/[slug]/page.js - This will match URLs like
/blog/hello-worldor/blog/nextjs-tips.
Accessing Dynamic Parameters
When a dynamic route is matched, the value of the dynamic segment (e.g., slug) is passed to your page component as a property of the params object.
By default, Next.js App Router pages are React Server Components, which receive params as a prop.
// File: app/blog/[slug]/page.js
export default function BlogPostPage({ params }) {
const { slug } = params; // If URL is /blog/my-post, slug will be 'my-post'
return (
<main>
<h1>Blog Post: {decodeURIComponent(slug)}</h1>
<p>This content is for the post identified by '{decodeURIComponent(slug)}'.</p>
</main>
);
}Introducing Catch-all Segments
What if you need to match URLs with an unknown number of segments? For example, a documentation site where paths can be deeply nested (e.g., /docs/getting-started/installation).
This is where catch-all segments come in. They capture all subsequent path segments into an array.
Creating Catch-all Routes
To create a catch-all route, use three dots followed by the segment name inside square brackets: [...slug].
This will match any path that starts with the parent folder and capture all parts after it into an array.
- Example:
app/docs/[...slug]/page.js - Matches:
/docs/a,/docs/a/b,/docs/a/b/c. slugwill be an array:['a'],['a', 'b'],['a', 'b', 'c'].
Accessing Catch-all Parameters
Similar to dynamic segments, catch-all parameters are available via the params object. However, the value for a catch-all segment is always an array of strings.
Let's see an example of displaying the captured path segments from a URL like /docs/guide/setup/nextjs.
// File: app/docs/[...slug]/page.js
export default function DocsPage({ params }) {
const { slug } = params; // If URL is /docs/intro/setup, slug is ['intro', 'setup']
return (
<main>
<h2>Documentation Path: /{slug.join('/')}</h2>
<p>Segments found: {slug.map(s => `<code>${s}</code>`).join(', ')}</p>
</main>
);
}Optional Catch-all Segments
What if you want a catch-all route to also match the base path? For example, you want /docs to show an index page, but /docs/intro to show a specific guide.
You can make a catch-all segment optional by wrapping it in an extra set of square brackets: [[...slug]].
- Example:
app/docs/[[...slug]]/page.js - Matches:
/docsand/docs/a/b.
Optional Catch-all Example
When using [[...slug]], the slug parameter will be an array of strings for sub-paths. However, it will be undefined if only the base path is matched (e.g., /docs).
You'll need to handle the undefined case in your component to show default content.
// File: app/docs/[[...slug]]/page.js
export default function OptionalDocsPage({ params }) {
const { slug } = params; // If URL is /docs, slug is undefined
// If URL is /docs/intro, slug is ['intro']
const pathDisplay = slug ? slug.join('/') : 'Home Index';
return (
<main>
<h2>Docs: {pathDisplay}</h2>
<p>This page handles both the base path and any sub-paths.</p>
</main>
);
}Quick Check on Routing
Which of the following statements about Next.js dynamic and catch-all routes are TRUE?
Recap: Dynamic & Catch-all Routes
You've mastered how to make your Next.js application's routing incredibly flexible!
- Dynamic Segments (
[slug]) allow a single page to handle many specific URLs, receiving a string parameter. - Catch-all Segments (
[...slug]) capture multiple path segments into an array, useful for nested structures. - Optional Catch-all Segments (
[[...slug]]) extend catch-alls to also match the base path, with the parameter beingundefinedfor the base path.
These powerful patterns are fundamental for building scalable and content-rich applications in Next.js.
Często zadawane pytania
Czy lekcja „Trasy dynamiczne i segmenty catch-all” jest bezpłatna?
Tak — pełny tekst „Trasy dynamiczne i segmenty catch-all” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Next.js 15 Fullstack Web Apps, przejdź na CoddyKit PRO. Kurs Next.js 15 Fullstack Web Apps zawiera 4 lekcji w sumie.
Co nauczysz się w „Trasy dynamiczne i segmenty catch-all”?
Twórz elastyczne trasy dopasowujące się do dynamicznej zawartości za pomocą segmentów dynamicznych i tras catch-all. Ćwiczysz Next.js 15 Fullstack Web Apps z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Next.js 15 Fullstack Web Apps?
Nie wymagamy żadnego doświadczenia. Next.js 15 Fullstack Web Apps w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.
Ile czasu zajmuje lekcja „Trasy dynamiczne i segmenty catch-all”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Next.js 15 Fullstack Web Apps?
Tak. Każda lekcja Next.js 15 Fullstack Web Apps zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Trasy dynamiczne i segmenty catch-all
- Zagnieżdżone układy i grupy tras
- Trasy równoległe i przechwytujące
- Konwencje interfejsów ładowania i błędów